跳转到主要内容
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0",
    "action": "generate",
    "prompt": "一只柴犬穿宇航服站在月球上",
    "size": "16:9",
    "resolution": "2K",
    "watermark": false
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "seedream-5.0",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
异步处理模式 — 提交请求后返回任务 ID，通过 查询任务状态 接口获取生成结果。图片链接有效期 24 小时，请及时保存。 
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0",
    "action": "generate",
    "prompt": "一只柴犬穿宇航服站在月球上",
    "size": "16:9",
    "resolution": "2K",
    "watermark": false
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "seedream-5.0",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

​
可用模型

模型 ID说明
seedream-5.0Seedream 5.0，支持组图、联网搜索、流式输出
seedream-4.5Seedream 4.5，支持组图、4K 分辨率
seedream-4.0Seedream 4.0，支持组图、1K~4K 分辨率

​
统一参数

​
model
string
必填
模型组名称：seedream-5.0、seedream-4.5、seedream-4.0
​
action
string
默认值:"generate"
操作类型
​
prompt
string
必填
文本提示词，支持中英文，建议不超过 300 个汉字
​
image_urls
string[]
参考图片 URL 数组，最多 14 张，每张不超过 10MB
​
size
string
默认值:"1:1"
宽高比：1:1、2:3、3:2、3:4、4:3、9:16、16:9、21:9
​
resolution
string
默认值:"2K"
分辨率，可选值取决于模型，见各模型 Tab
​
n
integer
默认值:"1"
生成数量，大于 1 时启用组图模式
​
watermark
boolean
默认值:"true"
是否添加水印
​
callback_url
string
任务完成时的 Webhook 回调地址
​
extra
object
透传给上游的额外参数，详见各模型 Tab

​
模型特定参数

resolution 可选值： 2K、3Ksize 额外支持： 4:5、5:4
​
extra.output_format
string
默认值:"jpeg"
输出图片格式：png、jpeg
​
extra.response_format
string
默认值:"url"
返回格式：url（下载链接）或 b64_json（Base64）
​
extra.stream
boolean
默认值:"false"
流式输出，即时返回每张图片结果
​
extra.optimize_prompt_options
object
提示词优化配置
​
extra.tools
array
模型工具，支持联网搜索提升时效性
"extra": { "tools": [{"type": "web_search"}] }

​
生成模式

模式参数说明
文生图prompt纯文本生成
单图生图prompt + image_urls(1张)参考图 + 文本
多图生图prompt + image_urls(2-14张)多张参考图融合
组图n > 1生成一组关联图片
组图模式下，输入参考图数量 + 生成图片数量 ≤ 15。

​
响应

​
task_id
string
任务 ID
​
model
string
使用的模型 ID
​
action
string
操作类型
​
status
string
任务状态：queued
​
created_at
integer
创建时间（Unix 毫秒时间戳）
​
progress
integer
进度，初始为 0