Seedance 2.0调用说明

本文着重介绍视频生成调用方式和官方的区别，具体细节可参考Seedance SDK官方教程

本平台调用示例

创建任务

下面的示例包含了所有生视频类型（文生视频 / 图生视频-首帧 / 图生视频-首尾帧 / 多模态参考）和所有可选参数，实际使用时只需在 content 中保留对应类型的媒体元素、并按需调整参数即可。

⚠️ 各生视频类型的媒体元素互斥（首帧 / 首尾帧 / 参考图不可混用），下例仅作为完整字段参考，请勿原样提交。

curl https://api.token-hubs.com/video/seedance-2-0 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动，可以听到风声"
        },
        {
            "type": "image_url",
            "image_url": { "url": "https://example.com/first.jpg" },
            "role": "first_frame"
        },
        {
            "type": "image_url",
            "image_url": { "url": "https://example.com/last.jpg" },
            "role": "last_frame"
        },
        {
            "type": "image_url",
            "image_url": { "url": "asset://your_asset_id" },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": { "url": "https://example.com/ref.mp4" },
            "role": "reference_video"
        },
        {
            "type": "audio_url",
            "audio_url": { "url": "https://example.com/ref.wav" },
            "role": "reference_audio"
        }
    ],
    "resolution": "720p", // 取值：480p、720p、1080p
    "ratio": "adaptive", // 取值：16:9、4:3、1:1、3:4、9:16、21:9、adaptive
    "duration": 5, // 取值范围：[4, 15]
    "watermark": false, // 取值：true、false
    "generate_audio": true, // 取值：true、false
    "return_last_frame": false, // 取值：true、false
    "tools": [{ "type": "web_search" }], // 暂不支持
    "callback_url": "https://your-domain.com/callback", // 暂不支持
    "execution_expires_after": 172800, // 暂不支持，默认为172800
    "safety_identifier": "your-user-id", // 暂不支持
    "priority": 0 // 暂不支持，默认为0
}'

返回体（创建成功后返回任务 id，用于后续查询任务状态）：

{
  "id": "cgt-xxxxxxxxxxxxxx-xxxxx"
}

查询任务

curl -X GET "https://api.token-hubs.com/video/seedance-2-0/{task_id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

返回体的内容随任务状态变化，主要有以下两种：

1. 任务进行中（status 为 queued / running）：尚未生成视频，无 content 字段。

{
  "updated_at": 1782356464,
  "execution_expires_after": 172800,
  "draft": false,
  "created_at": 1782356464,
  "model": "doubao-seedance-2-0-260128",
  "service_tier": "default",
  "id": "cgt-xxxxxxxxxxxxxx-xxxxx",
  "generate_audio": true,
  "priority": 0,
  "status": "running"
}

2. 任务成功（status 为 succeeded）：content.video_url 即为生成视频的下载地址。

{
  "seed": 12345,
  "execution_expires_after": 172800,
  "usage": {
    "completion_tokens": 245025,
    "total_tokens": 245025
  },
  "created_at": 1782356464,
  "generate_audio": true,
  "priority": 0,
  "resolution": "1080p",
  "content": {
    "video_url": "https://example.com/doubao-seedance-2-0/xxxxxxxx.mp4?X-Tos-Algorithm=...&X-Tos-Credential=...&X-Tos-Date=...&X-Tos-Expires=86400&X-Tos-Signature=...&X-Tos-SignedHeaders=host"
  },
  "duration": 5,
  "framespersecond": 24,
  "updated_at": 1782356623,
  "draft": false,
  "model": "doubao-seedance-2-0-260128",
  "service_tier": "default",
  "id": "cgt-xxxxxxxxxxxxxx-xxxxx",
  "status": "succeeded",
  "ratio": "16:9"
}

视频生成为异步任务，需轮询本接口直到 status 变为 succeeded，再从 content.video_url 获取视频。video_url 含签名且有有效期（示例中约 24 小时），请及时下载转存。

注意事项

请求参数说明

请求结构与官方一致：model、content 数组及其他配置参数（resolution、ratio、duration 等）均直接置于请求体顶层，与官方接口保持一致。
content 字段：提示词文本作为 type 为 "text" 的元素放入 content 数组，媒体元素（图片 / 视频 / 音频）通过 role 区分用途。
接口地址：仅需将官方地址替换为本平台地址 https://api.token-hubs.com/video/seedance-2-0，其余参数用法与官方教程相同。

#Seedance 2.0调用说明

#本平台调用示例

#创建任务

#查询任务