xmsmartlink Docs

外观

统一视频任务查询 ​

查询通过统一视频生成接口创建的任务。

适用场景 ​

已经通过统一视频创建接口获得 task_id，需要查询任务状态、进度和结果时使用该接口。该接口可安全重试，不应通过重复创建视频任务代替查询。

Base URL ​

https://vip.xmsmartlink.com

鉴权 ​

Authorization: Bearer YOUR_API_KEY

Endpoint ​

GET /v1/video/generations/{task_id}

路径参数 ​

移动端可横向滑动查看完整参数。

参数类型必填说明
task_idstring是创建接口返回的公开任务 ID。

请求示例 ​

bash
curl -X GET 'https://vip.xmsmartlink.com/v1/video/generations/task_abc123xyz' \
  -H 'Authorization: Bearer YOUR_API_KEY'

状态与重试 ​

  • queued、pending、running：任务未完成，等待后再次查询。
  • succeeded、success：成功终态，分别从 video_url 或 url 读取结果。
  • failed、failure：失败终态，记录 error 后再决定是否创建新任务。
  • 若模型返回 cancelled，它也是终态；停止查询且不要默认重新创建。
  • 查询遇到网络错误时可按退避策略重试；响应包含 Retry-After 时优先遵守，且不得低于具体模型规定的最低查询间隔。
  • 本接口没有回调参数，直接查询状态；不要因查询失败重复创建视频任务。

响应字段 ​

字段类型说明
id / task_idstring任务 ID。
modelstring创建任务时使用的模型。
statusstring当前任务状态。
progressinteger 或 string任务进度。
video_url / urlstring不同模型返回的视频地址。
created_atinteger创建时间戳。
completed_atinteger完成时间戳。
errorstring失败原因。

响应示例 ​

json
{
  "id": "task_abc123xyz",
  "task_id": "task_abc123xyz",
  "model": "wan2.7-i2v",
  "status": "succeeded",
  "progress": 100,
  "video_url": "https://output.example.com/video.mp4",
  "created_at": 1712832000,
  "completed_at": 1712832120,
  "object": "video"
}

Seedance 统一接口成功时可能返回字符串进度和 url：

json
{
  "id": "task_zmDRnean...",
  "task_id": "task_zmDRnean...",
  "status": "success",
  "progress": "100",
  "url": "https://example.com/generated-video.mp4",
  "created_at": 1775720240,
  "completed_at": 1775720583,
  "model": "doubao-seedance-2-0-260128"
}

API Reference ​

查看底层接口定义