Skip to main content
向派发器轮询由 /tasks/submit 发起的任务当前状态。 返回此刻已知的一切 —— pendingrunning,或者三个终态之一 (completedfailedcancelled)。 要实时投递(服务端推送状态变化,而不是客户端轮询),用 GET /v1/tasks/stream/{task_id}(SSE),或者在 submit 时注册一个 callback_url

何时选用

  • 廉价轮询循环 —— /tasks/query 免费;按任务的 estimated_seconds 匹配的节奏来调用
  • 进程重启后对账 —— 你的客户端挂了,DB 里只剩 out_task_id; 用它查询恢复当前状态
  • 取最终输出 —— statuscompleted 后,output 数组里就是 生成的图像 / 视频

Request

按 task_id

按 out_task_id(幂等键)

Body

task_idout_task_id 必填其一。同时给两个返回 400 invalid_param

Response

Running 状态

完成后

失败后

Response 字段

轮询节奏

把轮询间隔匹配到 submit 响应里模型的 estimated_seconds。视频的一个 不错的默认:
要零轮询投递,优先用 callback_url(submit 时设)或 SSE stream 端点。

错误

价格

免费。 轮询不消耗 credits。只有 completed 任务扣费(通过原始 submit)。无限次重新查询一个已完成任务,零成本。

下一步