xmsmartlink Docs

外观

Seedance-2 查询 ​

查询 Seedance-2 视频任务状态和生成结果。如果创建请求配置了 callback_url，请先等待回调，仅在创建 10 分钟后仍未收到回调再主动查询；如果未配置 callback_url，也应在创建 10 分钟后再首次查询。

适用场景 ​

已经通过 Seedance-2 创建接口获得任务 id，并且已按上述规则等待 10 分钟，需要主动查询状态时使用该接口。

Base URL ​

https://vip.xmsmartlink.com

Endpoint ​

GET /v1/task/get/{id}

请求头 ​

Header必填说明
Authorization是Bearer <API_KEY>。
X-Trace-ID否请求跟踪 ID，建议每次请求唯一，便于排查问题。

路径参数 ​

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

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

请求示例 ​

bash
curl -X GET https://vip.xmsmartlink.com/v1/task/get/cgt-20260421174743-w9q85 \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Trace-ID: $TRACE_ID"

状态与重试 ​

  • 首次查询应遵守创建后的 10 分钟等待规则；后续每个任务每分钟最多查询一次，即两次查询之间至少等待 60 秒。
  • running 表示任务仍在处理；succeeded 表示成功终态；failed 和 cancelled 表示失败或取消终态，均应停止查询。
  • 查询出现网络错误时可以重试，但重试间隔仍不得低于 60 秒。响应包含 Retry-After 时，取 Retry-After 与 60 秒中的较大值。
  • 取消任务后不要默认重新创建；先确认取消原因和业务意图。
  • 不要通过重复创建任务代替查询。成功后通常需要在 24 小时内下载并保存视频。
  • 轮询、回调和幂等规则请查看异步任务指南。

响应字段 ​

字段说明
code平台业务状态，例如 success。
message平台提示信息。
data.status任务状态，例如 running、succeeded、failed。
data.content.video_url生成视频下载链接。
data.content.last_frame_url尾帧地址。
data.cost平台计费对象。
data.usage任务用量信息。

响应示例 ​

json
{
  "code": "success",
  "message": "",
  "data": {
    "id": "cgt-20260421174743-w9q85",
    "model": "doubao-seedance-2.0",
    "status": "succeeded",
    "content": {
      "last_frame_url": null,
      "video_url": "https://example.com/generated-video.mp4"
    },
    "cost": {
      "currency": "CNY",
      "input_cost": "0.0000000000",
      "output_cost": "5.0093914000",
      "total_cost": "5.0093914000"
    },
    "created_at": 1776764863,
    "updated_at": 1776765155,
    "duration": 5,
    "execution_expires_after": 172800,
    "framespersecond": 24,
    "generate_audio": true,
    "ratio": "9:16",
    "resolution": "720p",
    "seed": 54405,
    "service_tier": "default",
    "usage": {
      "completion_tokens": 108900,
      "total_tokens": 108900
    }
  }
}

API Reference ​

底层接口定义已收录在左侧“底层 API Reference / Seedance-2 视频”分组中。