Skip to main content

路径参数

string
必填
从创建视频请求返回的任务 ID。将 idtask_id 视为相同的异步标识。
如果创建响应返回 poll_url,请调用该精确 URL。当它指向 /v1/tasks/{id} 时,将其视为规范的固定状态端点。如果该任务已不存在或无法再从公开任务记录中查询到,AI Sonar 会返回 async_task_not_found,并附带消息 Task not found or no longer available.

响应

string
规范的异步任务标识符。
string
异步任务标识符别名。
string
当创建响应提供时的首选轮询 URL。
string
当结算已经完成时返回 AI Sonar 账单交易 ID。它对应 dashboard / 对账使用的交易标识,与异步 id / task_id 不同。
string
任务状态:pendingprocessingcompletedfailed
number
可选进度值。仅在任务提供真实进度时返回;请使用 status 判断任务是否完成。
string
生成视频的 URL(完成时)。
object
单个视频负载,在可用时包含 urldurationwidthheight
array
当生成任务返回多个输出时的多个视频负载。
string
错误信息(如果失败)。
integer
创建时间戳。
integer
最后更新时间戳。
string
用于该任务的模型。

轮询最佳实践

  • 每 5-10 秒轮询一次
  • 为长期任务实现指数退避
  • 设置最大超时(例如 10 分钟)
  • 优雅地处理 failed 状态