统一视频任务查询

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

适用场景

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

Base URL

https://api.xmsmartlink.cn

鉴权

Authorization: Bearer YOUR_API_KEY

Endpoint

GET /v1/video/generations/{task_id}

路径参数

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

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

请求示例

bash

curl -X GET 'https://api.xmsmartlink.cn/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_id`	string	任务 ID。
`model`	string	创建任务时使用的模型。
`status`	string	当前任务状态。
`progress`	integer 或 string	任务进度。
`video_url` / `url`	string	不同模型返回的视频地址。
`created_at`	integer	创建时间戳。
`completed_at`	integer	完成时间戳。
`error`	string	失败原因。

响应示例

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

查看底层接口定义

统一视频任务查询 ​

适用场景 ​

Base URL ​

鉴权 ​

Endpoint ​

路径参数 ​

请求示例 ​

状态与重试 ​

响应字段 ​

响应示例 ​

API Reference ​