跳转到主要内容
POST
/
v1
/
tasks
curl --request POST \
  --url https://qingbo.dev/v1/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-image",
    "prompt": "星空下的古老城堡，数字艺术风格",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://example.com/reference.png"
    ]
  }'

{
  "code": "success",
  "data": "task-wave17486161910001884721"
}
异步处理模式： 提交请求后返回任务 ID，请通过 查询任务状态 接口获取生成结果。生成的图片链接有效期为 24 小时，请及时保存。
curl --request POST \
  --url https://qingbo.dev/v1/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-image",
    "prompt": "星空下的古老城堡，数字艺术风格",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://example.com/reference.png"
    ]
  }'

{
  "code": "success",
  "data": "task-wave17486161910001884721"
}

​
认证方式

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
请求参数

​
model
string
默认值:"gpt-4o-image"
必填
图像生成模型名称示例："gpt-4o-image"
​
prompt
string
必填
图像生成的文字描述最大 1000 个字符
​
size
string
图像生成尺寸支持的比例：
  • 1:1 - 正方形
  • 2:3 - 竖版
  • 3:2 - 横版
​
n
integer
生成图像的数量支持 1、2、4，费用将按数量预扣默认值：1⚠️ 注意： 必须输入纯数字（如 1），不要使用引号包裹
​
image_urls
array<url>
参考图像 URL 列表，用于图生图或图片编辑限制： 最多 5 张图片
​
mask_url
string
遮罩图像 URL
  • 必须为 PNG 格式
  • 尺寸必须与参考图像一致
  • 最大 4MB

​
响应参数

​
code
string
响应状态码
  • success - 请求成功，任务已提交
​
data
string
任务 ID，格式为 task-wave{timestamp}{userId}{random}用于通过 查询任务状态 接口获取生成结果

​
注意事项

  1. 异步处理： 任务提交后异步处理，请通过 查询任务状态 获取生成结果
  2. 链接有效期： 生成的图片链接有效期为 24 小时，请及时下载保存
  3. 图片 URL 要求： 输入的参考图片必须为公开可访问的 URL 或 Base64 格式
  4. 费用说明： 当 n 大于 1 时，费用将按数量预扣