任务管理
提交任务
POST /v1/tasks — 提交异步生成任务
POST
提交任务
提交图像、视频或音频生成任务,立即返回
更多参数请参考 图像生成概述 或 视频生成概述。
适合图像生成等较快完成的任务、原型开发和测试。视频等长耗时任务建议轮询或 Webhook。
task_id。
请求参数
string
必填
模型名称,如
"veo3", "gpt-4o-image", "seedance-2.0"string
默认值:"generate"
操作类型:
generate, edit, upscale, variation, blendstring
生成描述文本
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}轮询
幂等提交(Idempotency-Key)
带Idempotency-Key: <唯一字符串> 请求头提交时,24 小时内同一 key 的重复请求会
直接复用首次创建的任务(同一 task_id,不重复扣费)。适合网络重试场景。