Skip to main content
GET
查询视频生成任务
使用创建接口返回的任务 id 轮询本接口,直到任务到达终态。生产环境建议在创建请求中设置 callback_url,避免高频轮询。任务记录的保留窗口与 APIPod 原生任务一致;任务成功后请及时下载或转存视频 URL。

任务状态

用量与费用

statussucceeded 时,响应携带 usage 对象,包含本任务的最终扣费金额。cost 为完成后的结算金额(USD),与控制台展示一致;它是 APIPod 对方舟契约的扩展字段,始终返回。token 字段仅在上游回传用量时出现。 任务不存在与任务属于其他账号统一返回 404,两种情况不做区分。

授权

Authorization
string
header
必填

在 Authorization 头中以 Bearer 方式携带 APIPod API Key。

路径参数

id
string
必填

创建接口返回的任务 ID。

响应

任务状态快照

id
string
必填

任务 ID。

model
string
必填

本任务使用的公开模型系列名。

status
enum<string>
必填

方舟语义的任务状态。

可用选项:
queued,
running,
succeeded,
failed,
cancelled
content
object

输出内容,仅在任务成功后出现。

created_at
integer

任务创建时间(Unix 秒级时间戳)。

updated_at
integer

任务最近一次状态更新时间(Unix 秒级时间戳)。

error
object

仅在任务失败时出现。

usage
object

终态用量快照,仅在任务成功后出现。