原站参考文档

以下为胜算云公开资料。文中的原站账号、地址、定价和专有服务不属于蓝天；蓝天可用模型以当前 sub2api 配置为准。接入蓝天请先查看快速开始。

Flux-dev-lora

black-forest-labs/flux-dev-lora
异步任务：POST /v1/tasks/generations 提交 → GET /v1/tasks/generations/{request_id} 轮询结果（POST 发送后 request_id 自动填入 GET）。

BASE URLhttps://router.shengsuanyun.com/api

认证方式Authorization: Bearer YOUR_API_KEY

端点列表

← 上一页

Flux-kontext-dev

Flux-1.1-pro-ultra-finetuned

接口参考

以下为原文协议定义与示例，原站地址不代表蓝天已开通对应能力。蓝天接入地址和模型以本地配置为准。

蓝天 API 密钥

POST/v1/tasks/generationsFlux 图像生成-异步

异步任务：POST 提交后返回 request_id，再用 GET /v1/tasks/generations/{request_id} 轮询结果。

请求体

application/json

object

anyOf · 1

字段	类型	说明
`prompt`必填	stringtextarea	描述你想生成的图像内容
`aspect_ratio`	string	生成图片的宽高比例可选值："1:1" · "16:9" · "21:9" · "3:2" · "2:3" · "4:5" · "5:4" · "3:4" · "4:3" · "9:16" · "9:21"
`lora_weights`	string	LoRA模型权重文件的路径或URL，支持Replicate、HuggingFace、CivitAI等来源
`lora_scale`	number	主LoRA模型的影响强度，建议0-1之间，快速模式会自动乘以1.5倍
`extra_lora`	string	额外的LoRA模型权重文件路径或URL
`extra_lora_scale`	number	额外LoRA模型的影响强度
`megapixels`	string	图片的百万像素数量，1为标准大小，0.25为1/4大小可选值："1" · "0.25"
`num_outputs`	integer	一次生成的图片数量
`num_inference_steps`	integer	去噪步数，建议28-50，步数越少速度越快但质量越低
`guidance`	number	引导生成的强度
`output_format`	string	输出图片的文件格式可选值："webp" · "jpg" · "png"
`output_quality`	integer	图片质量，0-100，100为最佳质量。对png格式无效
`go_fast`	boolean	启用快速模式(fp8量化)，速度更快但结果不确定，即使设置种子也不可重现
`disable_safety_checker`	boolean	禁用NSFW安全检查器
`seed`	integer	设置固定种子以获得可重复的结果(快速模式下无效)
`model`必填	string	路由模型，本页固定为 black-forest-labs/flux-dev-lora

anyOf · 2

字段	类型	说明
`prompt`必填	stringtextarea	描述你想如何编辑或转换图像
`image`必填	string	用于图生图的参考图片，输出将匹配此图片的宽高比
`prompt_strength`	number	图生图时提示词的影响强度，1.0表示完全破坏原图信息
`lora_weights`	string	LoRA模型权重文件的路径或URL，支持Replicate、HuggingFace、CivitAI等来源
`lora_scale`	number	主LoRA模型的影响强度，建议0-1之间，快速模式会自动乘以1.5倍
`extra_lora`	string	额外的LoRA模型权重文件路径或URL
`extra_lora_scale`	number	额外LoRA模型的影响强度
`megapixels`	string	图片的百万像素数量，1为标准大小，0.25为1/4大小可选值："1" · "0.25"
`num_outputs`	integer	一次生成的图片数量
`num_inference_steps`	integer	去噪步数，建议28-50，步数越少速度越快但质量越低
`guidance`	number	引导生成的强度
`output_format`	string	输出图片的文件格式可选值："webp" · "jpg" · "png"
`output_quality`	integer	图片质量，0-100，100为最佳质量。对png格式无效
`go_fast`	boolean	启用快速模式(fp8量化)，速度更快但结果不确定，即使设置种子也不可重现
`disable_safety_checker`	boolean	禁用NSFW安全检查器
`seed`	integer	设置固定种子以获得可重复的结果(快速模式下无效)
`model`必填	string	路由模型，本页固定为 black-forest-labs/flux-dev-lora

{
  "aspect_ratio": "1:1",
  "disable_safety_checker": false,
  "extra_lora_scale": 1,
  "go_fast": true,
  "guidance": 3,
  "lora_scale": 1,
  "lora_weights": "huggingface.co/alvdansen/softserve_anime",
  "megapixels": "1",
  "model": "black-forest-labs/flux-dev-lora",
  "num_inference_steps": 28,
  "num_outputs": 1,
  "output_format": "jpg",
  "output_quality": 80,
  "prompt": "a girl wearing a duck themed raincaot, sftsrv style"
}

请求示例

参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/api/v1/tasks/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "aspect_ratio": "1:1",
  "disable_safety_checker": false,
  "extra_lora_scale": 1,
  "go_fast": true,
  "guidance": 3,
  "lora_scale": 1,
  "lora_weights": "huggingface.co/alvdansen/softserve_anime",
  "megapixels": "1",
  "model": "black-forest-labs/flux-dev-lora",
  "num_inference_steps": 28,
  "num_outputs": 1,
  "output_format": "jpg",
  "output_quality": 80,
  "prompt": "a girl wearing a duck themed raincaot, sftsrv style"
}'

响应

200 提交成功，返回 request_id / task_id

application/json

未提供结构定义。

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "REQ_xxx",
    "task_id": "TASK_xxx",
    "action": "GENERATION",
    "status": "PENDING",
    "progress": "0%"
  }
}

400 请求参数错误

401 未授权（API Key 无效）

429 请求过于频繁

500 服务器内部错误

GET/v1/tasks/generations/{request_id}查询异步任务状态与产物

通过 POST /v1/tasks/generations 返回的 request_id 轮询任务状态、进度与产物 URL（image_urls / video_urls / audio_urls / file_urls / text）。下方「在线测试」填入 request_id 即可发送查询；若上方 POST 已发送成功，request_id 会自动填入。

请求参数

参数	位置 / 类型	说明
`request_id`必填	path / string	POST /v1/tasks/generations 返回的请求 ID

请求示例

参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X GET 'https://router.shengsuanyun.com/api/v1/tasks/generations/{request_id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

响应

200 任务状态与产物

application/json

未提供结构定义。

{
  "image_urls": [
    "https://oss.shengsuanyun.com/example/modelinfo/200/2025-10-15_11:33:19_output_1.jpg"
  ],
  "progress": 100
}

400 请求参数错误

401 未授权（API Key 无效）

429 请求过于频繁

500 服务器内部错误