跳转到主要内容
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 时,费用将按数量预扣