​
Seedance-2 查询

查询 Seedance-2 视频任务状态和生成结果。建议优先使用创建接口中的 callback_url 接收状态变化回调；如果创建 10 分钟后仍未收到回调，再主动查询。

​
Base URL

https://vip.xmsmartlink.com/

​
Endpoint

GET /v1/task/get/{id}

​
请求头

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

​
路径参数

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

​
查询频率

每个任务最多每分钟查询一次，避免频繁轮询。任务状态为 running 时，等待一段时间后再查询；任务完成后，响应中的视频下载链接通常需要在 24 小时内下载保存。

​
请求示例

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

​
响应字段

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

​
响应示例

{
  "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 视频”分组中。