Amux AI

Retrieve video task

最近更新:2026年11月22日

按火山方舟原生格式查询 bytedance/seedance-2.5-flash 视频生成任务状态与结果。

按火山方舟原生响应格式查询 bytedance/seedance-2.5-flash 的任务状态与生成结果。该端点与统一查询接口访问同一任务记录,仅响应结构不同。

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

鉴权

header
Authorizationstring必填

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