Skip to main content

概览

使用此端点对视频、图像、音乐和 3D 生成等任务类型进行统一的异步轮询。 如果 create 响应包含 poll_url,请调用该精确路径。某些图像模型可能会在图像特定的状态路径或 /v1/tasks/{id} 下返回基于任务的响应。

路径参数

string
必填
由 create 请求返回的任务 ID。

响应

string
规范的异步任务标识符。
string
异步任务标识符别名。
string
当 create 响应提供时,首选的轮询 URL。
string
任务状态,例如 pendingprocessingcompletedfailed。已取消的任务会表示为 failed 并带有 cancelled: true
boolean
排队中的异步任务在执行前被取消时为 true
string
取消标记。取消成功时为 cancelled
array
对于已完成的图片任务,生成的图片结果会在这里返回。图片任务会在 data[].url 中返回 URL。
number
可选进度值。仅在任务提供真实进度时返回;请使用 status 判断任务是否完成。
string
任务完成并生成视频时的结果资源 URL。
object
单个视频负载,包含在可用时的 urldurationwidthheight
array
当存在多个输出时的多个视频负载。
string
任务失败时的错误信息。
integer
可用时的创建时间戳。
integer
可用时的上次更新时间戳。
string
可用时任务使用的模型。

错误行为

如果任务不再存在、已过期或无法再从公开任务记录中查询到,AI Sonar 将返回:

示例

Python
JavaScript