Amux

Retrieve video task

最近更新:2026年9月8日

按火山方舟形状查 bytedance/doubao-seedance-2-5 的任务。与统一取回口查的是同一个任务。

按火山方舟的形状查 bytedance/doubao-seedance-2-5 的任务。它和统一取回口 查的是同一个任务,只是渲染成两种形状。

GEThttps://gateway.amux.ai/api/v3/contents/generations/tasks/{id}

鉴权

header
Authorizationstring必填

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_tokensusage.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>"
  }
}