Skip to main content
POST
提交任务
提交图像、视频或音频生成任务,立即返回 task_id。

请求参数

string
必填
模型名称,如 "veo3", "gpt-4o-image", "seedance-2.0"
string
默认值:"generate"
操作类型:generate, edit, upscale, variation, blend
string
生成描述文本
string
任务完成时的 Webhook 回调地址
object
已弃用
不再接受。模型特有参数直接放在请求体根级,且只接受对应模型文档中声明的参数; 传入非空 extra 会返回 400,不计费(code: capability_violation,param: extra)。
更多参数请参考 图像生成概述 或 视频生成概述。

响应

integer
提交时冻结的额度(quota)。任务完成后以查询接口返回的 cost 为准结算: 成功 = 实际扣费;失败/取消 = 自动全额退款(cost: 0)。

请求内等待(Prefer: wait)

不想自己轮询时,加 Prefer: wait=N 请求头(N ≤ 60 秒)即可在一次调用里等待结果:
  • 窗口内完成 → 直接返回终态完整结果(含 result 与 cost)
  • 超窗未完成 → 返回当前状态 + pre_consumed_cost,继续用 GET /v1/tasks/{task_id} 轮询
适合图像生成等较快完成的任务、原型开发和测试。视频等长耗时任务建议轮询或 Webhook。

幂等提交(Idempotency-Key)

带 Idempotency-Key: <唯一字符串> 请求头提交时,24 小时内同一 key 的重复请求会 直接复用首次创建的任务(同一 task_id,不重复扣费)。适合网络重试场景。

示例