Amux

Retrieve Seedance task

最近更新：2026年9月7日

按火山方舟形状查询视频任务。它是别名——和统一端点返回的是同一个任务。

用提交时返回的 ID 查一个视频任务，响应按火山方舟的形状渲染。

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

鉴权

header
Authorizationstring必填

Bearer <你的 Amux 密钥> 控制台创建的 Amux 密钥。忘了可以回控制台的密钥页再看一次。

请求

idstring必填

提交时拿到的 Amux 任务 ID。

响应

200response

无论跑完没跑完都是 200——状态在 status 里。

404response

这个工作区里没有这个任务。

和统一取回口的关系

这条端点返回的是和 GET /v1/tasks/{id} 同一个任务：一张任务表、一个 ID、一份数据，只在最后一步渲染成两种形状。

提供它是因为方舟的客户端会自己拼这个地址；不挂的话，改一个 base_url 之后 提交成功、取回 404。

新接入应该用统一端点，它带 usage 与 cost，而方舟这种形状里没有对应字段。 这条端点也不返回上游的 usage / resolution / duration——要用量就走统一端点。

状态字段

无论跑完没跑完都是 200。 状态在 status 里，轮询只要读这一个字段。

status含义收不收钱
queued排队中—
running生成中—
succeeded完成，产物在 content.video_url按实际用量收
failed上游拒绝或出错不收，预扣释放
cancelled已取消不收，预扣释放
expired执行超时，上游已终止不收，预扣释放

⚠️ 注意 cancelled 是两个 l，跟着上游的拼法。 ⚠️ 产物字段是 content.video_url 而不是 content.url——这也是上游自己的叫法， 和 MiniMax 那种形状不一样。

轮询

视频生成比出图慢一个数量级，而耗时主要由排队决定，不随你要的时长线性增长。 建议：前 20 秒不轮，之后每 10–15 秒一次。

别按出片时长线性外推超时时间。

产物地址

content.video_url 指向 Amux 的存储，不是上游那个带供应商签名、会过期的临时地址。 这些地址会定期清理——要长期保留的东西请自行下载。

查不到返回 404

没有这个任务，或者这个任务不属于你的工作区——两种都返回同一个 404。

共用一个响应是有意的：分开的话，一个任务 ID 就能被拿去跨工作区探测存在性。

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