Retrieve video task
最近更新:2026年9月8日
按火山方舟形状查 bytedance/doubao-seedance-2-5 的任务。与统一取回口查的是同一个任务。
按火山方舟的形状查 bytedance/doubao-seedance-2-5 的任务。它和统一取回口
查的是同一个任务,只是渲染成两种形状。
GET
https://gateway.amux.ai/api/v3/contents/generations/tasks/{id}鉴权
headerAuthorizationstring必填Bearer <你的 Amux 密钥> 站内 API Key。
请求
idstring必填提交时返回的 Amux 任务 ID。
响应
200response无论跑没跑完都是 200,状态在 status 里。
404response当前工作区里没有这个任务。
它是别名,不是第二套存储
一个任务,两种渲染。它存在是因为方舟的客户端会自己拼这个 URL——不挂的话,
改一个 base_url 之后提交成功、取回 404。
状态词
| 状态 | 含义 |
|---|---|
queued / running | 还在跑,接着轮询 |
succeeded | 成功,产物在 content.video_url |
failed | 失败,原因在 error |
cancelled | 已取消。⚠️ 两个 l,跟着上游的拼法 |
expired | 超过了 execution_expires_after(默认 48 小时)。不收钱,预扣已经退回 |
用量
这条端点会按火山方舟字段返回 usage.completion_tokens 与 usage.total_tokens。
出片 token 数就是本次计费依据;费用可从统一形状那条查询。
产物地址指向我们的存储
不是上游那个带供应商签名、会过期的临时地址。⚠️ 字段名是 video_url 而不是 url,
这是上游自己的叫法,和 MiniMax 那种形状不一样。
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>"
}
}