Amux

Get xAI video task

最近更新：2026年9月13日

通过 xAI 原生形状取回视频任务。与 GET /v1/tasks/{id} 读取同一任务，仅渲染形状不同。

按 xAI 的响应形状取回任务。它与 GET /v1/tasks/{id} 读取的是同一个任务， 两者仅渲染形状不同，不存在两套存储。

GEThttps://gateway.amux.ai/v1/videos/{id}

鉴权

header
Authorizationstring必填

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

请求

idstring必填

提交时返回的 Amux 任务 ID。

响应

200response

无论任务是否完成均返回 200，状态位于 status 字段。

404response

当前工作区内不存在该任务。

为什么提供这条别名

xAI 官方客户端会自行拼接取回 URL。若不提供该路径，调用方将 base_url 指向本站后会出现「提交成功、取回 404」——而「仅更换 base_url 即可迁移」 正是本站兼容端点的设计目标。

任务状态

状态含义
pending生成中，需继续轮询
done已完成，产物地址位于 video.url
failed终态，失败原因位于 error

⚠️ 官方响应中另有 expired 状态，表示上游请求过期。本站不返回该状态： 本站侧的任务过期对调用方而言同样表示未获得产物，而按官方文档实现的重试逻辑 对 failed 与 expired 的处理本就一致。多返回一个状态只会增加调用方需要 识别却无法据此分支的取值。

video.duration 为实际输出时长

该字段是上游实际生成的秒数，而非请求中的 duration。两者在图生视频场景下 可能不同——输出时长跟随输入素材。计费依据的正是这个实际值。

产物地址

video.url 指向本站存储。链接会被清理，需要长期保存请尽快下载。 任务完成时产物已转存完毕，可直接下载。

响应中不包含 usage

本形状的响应中不包含用量与费用字段。

保留它们会引入一个与账单对不上的数值：本站的计费以站内价目表为准。

费用请通过 GET /v1/tasks/{id} 的 cost 字段或账单页查询。

cURL
curl https://gateway.amux.ai/v1/videos/{id} \
  -H "Authorization: Bearer $AMUX_API_KEY"
{
  "status": "pending",
  "model": "<string>",
  "video": {
    "url": "<string>",
    "duration": 0
  },
  "error": {
    "code": "invalid_argument",
    "message": "<string>"
  }
}