Retrieve video task
最近更新:2026年11月22日
按火山方舟原生格式查询 bytedance/seedance-2.5-flash 视频生成任务状态与结果。
按火山方舟原生响应格式查询 bytedance/seedance-2.5-flash 的任务状态与生成结果。该端点与统一查询接口访问同一任务记录,仅响应结构不同。
GET
https://gateway.amux.ai/api/v3/contents/generations/tasks/{id}鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> API 密钥(Bearer Token)。
请求
idstring必填提交任务时返回的任务 ID。
响应
200response返回当前任务状态与结果。
404response当前工作区下不存在该任务。
任务状态
| 状态 | 说明 |
|---|---|
queued / running | 排队或生成中,继续轮询 |
succeeded | 生成成功,视频访问地址位于 content.video_url |
failed | 生成失败,原因详见 error |
cancelled | 已取消(拼写与火山方舟原生接口一致,为双 l) |
expired | 超过 execution_expires_after(默认 48 小时)未完成,不计费且预扣额度自动释放 |
用量与费用
该端点返回火山方舟兼容字段 usage.completion_tokens(即计费视频 token 用量)与 usage.total_tokens。如需读取实际结算金额 cost,请调用统一查询接口。
产物地址
任务成功时,输出视频访问地址位于 content.video_url(字段名为 video_url 而非 url)。链接具有时效性,如需长期保存请及时下载。
cURL
curl https://gateway.amux.ai/api/v3/contents/generations/tasks/{id} \
-H "Authorization: Bearer $AMUX_API_KEY"{
"id": "<string>",
"model": "<string>",
"status": "queued",
"content": {
"video_url": "<string>"
},
"usage": {
"completion_tokens": 0,
"total_tokens": 0,
"tool_usage": {
"web_search": 0
}
},
"error": {
"code": "<string>",
"message": "<string>"
}
}