/tasks/submit 发起的任务当前状态。
返回此刻已知的一切 —— pending、running,或者三个终态之一
(completed、failed、cancelled)。
要实时投递(服务端推送状态变化,而不是客户端轮询),用
GET /v1/tasks/stream/{task_id}(SSE),或者在 submit 时注册一个
callback_url。
何时选用
- 廉价轮询循环 ——
/tasks/query免费;按任务的estimated_seconds匹配的节奏来调用 - 进程重启后对账 —— 你的客户端挂了,DB 里只剩
out_task_id; 用它查询恢复当前状态 - 取最终输出 ——
status为completed后,output数组里就是 生成的图像 / 视频
Request
按 task_id
按 out_task_id(幂等键)
Body
task_id 或 out_task_id 必填其一。同时给两个返回 400 invalid_param。
Response
Running 状态
完成后
失败后
Response 字段
轮询节奏
把轮询间隔匹配到 submit 响应里模型的estimated_seconds。视频的一个
不错的默认:
callback_url(submit 时设)或 SSE stream 端点。
错误
价格
免费。 轮询不消耗 credits。只有completed 任务扣费(通过原始
submit)。无限次重新查询一个已完成任务,零成本。
下一步
POST /tasks/cancel—— 终止未终态任务POST /tasks/submit—— 发起任务