Seedance2.0

概述

当前文档主要提供了 seedance2.0 的对接调用案例，文档中共提供了 5 个调用案例，建议可以从案例开始逐个尝试。

方式	输入组合	说明
案例 A（推荐起步）	图 + 文	先稳定调通，最容易定位问题
案例 B	图 + 视频 + 文	把视频当“运动参考”，保持画面风格由图控制
案例 C	图 + 音频 + 文	用于节奏感/氛围感增强，注意音频不能单独输入
案例 D（完整版）	图 + 视频 + 音频 + 文	商业成片场景，建议在 A/B/C 验证后再使用
案例 E（首尾帧）	首帧 + 末帧 + 文	指定首尾帧生成过渡视频，用于精准控制起始和结束画面

如接口鉴权对接上有问题，可参考接口文档。接口文档： https://docs.tkhub.ai/api-reference/视频生成/创建视频生成任务

环境地址

测试环境: http://116.62.234.39:3000
生产环境: https://api.tkhub.ai

API 接口

1. 提交视频生成任务

POST /v1/video/generations

认证

请在请求头中包含您的 API 密钥（具体调用说明请参考接口文档）：

Authorization: Bearer sk-Your-API-Key

curl 请求示例：

curl --location --request POST 'http://116.62.234.39:3000/v1/video/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sk-xxxxxxx' \
--data-raw '{
    "model": "bytedance/seedance-2.0",
    "prompt": "一辆汽车乘风破浪，冲向悉尼歌剧院",
    "duration": 4,
    "resolution": "720p"
}'

案例说明

案例 A：图 + 文

{
  "model": "bytedance/seedance-2.0",
  "prompt": "一辆汽车乘风破浪，冲向悉尼歌剧院",
  "images": [
    "https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2026%2F0402%2F8548d314j00tcvcze002pd000u000k0g.jpg&thumbnail=660x2147483647&quality=80&type=jpg",
    "https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2026%2F0402%2Fde89a202j00tcvcze001md000u000gwg.jpg&thumbnail=660x2147483647&quality=80&type=jpg"
  ],
  "duration": 4,
  "resolution": "480p"
}

案例 B：图 + 视频 + 文

{
  "model": "bytedance/seedance-2.0",
  "prompt": "变身成龙之后，飞到一片雪山和溪流的上空",
  "images": [
    "https://gips3.baidu.com/it/u=1039279337,1441343044&fm=3028&app=3028&f=JPEG&fmt=auto&q=100&size=f1024_1024"
  ],
  "duration": 4,
  "resolution": "480p",
  "metadata": {
    "generate_audio": true,
    "referenceVideoUrls": [
      "https://test-fshows-public.oss-cn-hangzhou.aliyuncs.com/tasks/files/2026/04/07/task_dFOdVscFv6UTM5dHIJWMqOx8GyB0I2aR.mp4?x-oss-credential=LTAI5t7i5hp8ySNLqncEfobz%2F20260407%2Fcn-hangzhou%2Foss%2Faliyun_v4_request&x-oss-date=20260407T061837Z&x-oss-expires=604800&x-oss-signature=31c2e1becff32ef95712ea025b1e146aebb7dd316901178924b5fccd916acdb2&x-oss-signature-version=OSS4-HMAC-SHA256"
    ]
  }
}

案例 C：图 + 音频 + 文

{
  "model": "bytedance/seedance-2.0",
  "prompt": "一辆汽车乘风破浪，冲向悉尼歌剧院,并且化身为龙，祥云满天",
  "images": [
    "https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2026%2F0402%2F8548d314j00tcvcze002pd000u000k0g.jpg&thumbnail=660x2147483647&quality=80&type=jpg",
    "https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2026%2F0402%2Fde89a202j00tcvcze001md000u000gwg.jpg&thumbnail=660x2147483647&quality=80&type=jpg"
  ],
  "duration": 4,
  "resolution": "480p",
  "metadata": {
    "generate_audio": true,
    "referenceAudioUrls": [
      "https://cdn.pixabay.com/audio/2025/04/15/audio_981caf755e.mp3"
    ]
  }
}

案例 D：图 + 视频 + 音频 + 文

{
  "model": "bytedance/seedance-2.0",
  "prompt": "一辆汽车乘风破浪，飞快开过湖面",
  "images": [
    "https://gips3.baidu.com/it/u=1039279337,1441343044&fm=3028&app=3028&f=JPEG&fmt=auto&q=100&size=f1024_1024"
  ],
  "duration": 4,
  "resolution": "480p",
  "metadata": {
    "generate_audio": true,
    "referenceAudioUrls": [
      "https://m704.music.126.net/20260403152936/0c5c6b4d74b62e8e07b59a6afd2a859b/jdyyaac/obj/w5rDlsOJwrLDjj7CmsOj/12203537925/19e4/d4a5/9bca/fb0b1bba558830f1784d5be84cd06d0c.m4a?vuutv=Bi266B79ZekVeTaQslMd38H0MXDXrRMbIKA8uNzy6v/vgxlr/hJTaDng/ucIisQxUsGFD/pgw8FscqnFEL9khw6+7B7K8ejly4zDBODON3M=&authSecret=0000019d52287574050f0aaf7e9e0007"
    ],
    "referenceVideoUrls": [
      "https://test-fshows-public.oss-cn-hangzhou.aliyuncs.com/tasks/files/2026/04/03/task_pUsPrPyNoRCZjYNEeck1Rxzoq447zkf1.mp4?x-oss-credential=LTAI5t7i5hp8ySNLqncEfobz%2F20260403%2Fcn-hangzhou%2Foss%2Faliyun_v4_request&x-oss-date=20260403T065307Z&x-oss-expires=604800&x-oss-signature=00f3c1b8c0aaf47f98eeef951a179e214a51032f47c7c7e670cc059cbf852130&x-oss-signature-version=OSS4-HMAC-SHA256"
    ]
  }
}

案例 E：首尾帧 + 文

通过指定首帧与末帧图片，生成从起始画面到结束画面的过渡视频，适用于需要精准控制起止画面的场景。

{
  "model": "bytedance/seedance-2.0",
  "prompt": "A cinematic reveal from still portrait to dynamic ending frame",
  "duration": 8,
  "resolution": "720p",
  "ratio": "16:9",
  "metadata": {
    "frame_mode": "first-last",
    "first_image": "https://example.com/first-frame.jpg",
    "last_image": "https://example.com/last-frame.jpg"
  }
}

curl 请求示例：

curl --location --request POST 'http://116.62.234.39:3000/v1/video/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sk-xxxxxxx' \
--data-raw '{
    "model": "bytedance/seedance-2.0",
    "prompt": "A cinematic reveal from still portrait to dynamic ending frame",
    "duration": 8,
    "resolution": "720p",
    "ratio": "16:9",
    "metadata": {
        "frame_mode": "first-last",
        "first_image": "https://example.com/first-frame.jpg",
        "last_image": "https://example.com/last-frame.jpg"
    }
}'

请求参数详解

model (模型)

类型: string
是否必填: 是
描述: 模型标识符（例如：“bytedance/seedance-2.0”）
示例: “bytedance/seedance-2.0”

prompt (提示词)

类型: string
是否必填: 是
描述: 要生成的视频内容描述文本
示例: “一辆汽车乘风破浪，冲向悉尼歌剧院”

images (参考图)

类型: array
是否必填: 否
描述: 用于参考的图片 URL 数组
格式: 字符串数组
示例: [“https://example.com/image1.jpg”, “https://example.com/image2.jpg”]

duration (时长)

类型: number
是否必填: 否
描述: 生成视频的时长（秒）
默认值: 4
范围: 1-10（因模型而异）
示例: 4

resolution (分辨率)

类型: string
是否必填: 否
描述: 视频分辨率
可选值: “720p”, “480p”（因模型而异）
默认值: “720p”
示例: “720p”

ratio (画面比例)

类型: string
是否必填: 否
描述: 视频画面宽高比，常配合首尾帧模式使用
示例: “16:9”

metadata (元数据)

类型: object
是否必填: 否
描述: 用于高级功能的额外元数据
包含属性:
- referenceVideoUrls: 参考视频 URL 数组
- referenceAudioUrls: 参考音频 URL 数组
- generate_audio: 是否自动生成音频
- frame_mode: 帧模式（如 “first-last”，用于首尾帧生成）
- first_image: 首帧图片 URL（配合 frame_mode 使用）
- last_image: 末帧图片 URL（配合 frame_mode 使用）

metadata.referenceVideoUrls (参考视频)

类型: array
是否必填: 否
描述: 视频生成时引用的视频 URL 数组，通常作为“运动参考”
格式: 字符串数组
示例: [“https://example.com/video.mp4”]

metadata.referenceAudioUrls (参考音频)

类型: array
是否必填: 否
描述: 视频生成时引用的音频 URL 数组
格式: 字符串数组
示例: [“https://cdn.pixabay.com/audio/2025/04/15/audio_981caf755e.mp3”]

metadata.generate_audio (音频生成开关)

类型: boolean
是否必填: 否
描述: 控制是否在视频生成过程中自动生成音频的开关
默认值: false
可选值:
- true: 启用音频生成，系统会根据提示词和参考内容自动生成匹配的背景音频
- false: 禁用音频生成，生成的视频将无音频

metadata.frame_mode (帧模式)

类型: string
是否必填: 否
描述: 帧模式，用于指定使用首尾帧生成过渡视频；启用后须同时提供 first_image 与 last_image
可选值: “first-last”（首尾帧模式）
示例: “first-last”

metadata.first_image (首帧图片)

类型: string
是否必填: 否（启用 frame_mode=first-last 时必填）
描述: 视频起始帧的图片 URL，配合 frame_mode 使用
格式: 字符串
示例: “https://example.com/first-frame.jpg”

metadata.last_image (末帧图片)

类型: string
是否必填: 否（启用 frame_mode=first-last 时必填）
描述: 视频结束帧的图片 URL，配合 frame_mode 使用
格式: 字符串
示例: “https://example.com/last-frame.jpg”

响应示例

提交任务响应示例

{
  "id": "task_90EKfyW3j6661gcwGKu3MH6KiWa1apxF",
  "task_id": "task_90EKfyW3j6661gcwGKu3MH6KiWa1apxF",
  "object": "video",
  "model": "bytedance/seedance-2.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1775540697
}

2. 查询视频生成任务状态

GET /v1/video/generations/{task_id}

调用示例

查询任务状态示例

curl --location --request GET 'http://116.62.234.39:3000/v1/video/generations/abcd1234efgh' \
--header 'Authorization: Bearer sk-ItqPxzQkxHCgCvniQNAVhQaHpXBoMWwNq9AjyjGBIEuNA67k'

查询任务响应示例

{
  "code": "success",
  "message": "",
  "data": {
    "id": 70,
    "created_at": 1775536340,
    "updated_at": 1775536502,
    "task_id": "task_VRjTVeqdHPbdjKxeCah9zDgHL7I88xca",
    "platform": "59",
    "user_id": 1,
    "group": "default",
    "channel_id": 4,
    "quota": 2000,
    "action": "generate",
    "status": "SUCCESS",
    "fail_reason": "",
    "result_url": "https://test-fshows-public.oss-cn-hangzhou.aliyuncs.com/tasks/files/2026/04/07/task_VRjTVeqdHPbdjKxeCah9zDgHL7I88xca.mp4?x-oss-credential=LTAI5t7i5hp8ySNLqncEfobz%2F20260407%2Fcn-hangzhou%2Foss%2Faliyun_v4_request&x-oss-date=20260407T043502Z&x-oss-expires=604800&x-oss-signature=72531281a62c20e480ad5095776d10cd8f5c3bc6a0496ad52b0624b544980a44&x-oss-signature-version=OSS4-HMAC-SHA256",
    "submit_time": 1775536340,
    "start_time": 1775536352,
    "finish_time": 1775536449,
    "progress": "100%",
    "properties": {
      "input": "",
      "upstream_model_name": "bytedance/seedance-2.0",
      "origin_model_name": "bytedance/seedance-2.0"
    },
    "data": {
      "id": "cgt-20260407123217-d6h4q",
      "seed": 39555,
      "draft": false,
      "model": "dreamina-seedance-2-0-260128",
      "ratio": "16:9",
      "usage": {
        "total_tokens": 40594,
        "completion_tokens": 40594
      },
      "status": "succeeded",
      "content": {
        "video_url": "https://ark-acg-ap-southeast-1.tos-ap-southeast-1.volces.com/dreamina-seedance-2-0/02177553634005600000000000000000000ffffc0a88f20b19e47.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260407%2Fap-southeast-1%2Ftos%2Frequest&X-Tos-Date=20260407T043404Z&X-Tos-Expires=86400&X-Tos-Signature=18f6dbd4a725effa7c062b7e709f4b81a88e9cc7d10564f5620eee16219dd0ee&X-Tos-SignedHeaders=host"
      },
      "duration": 4,
      "created_at": 1775536339,
      "resolution": "480p",
      "updated_at": 1775536448,
      "service_tier": "default",
      "generate_audio": false,
      "framespersecond": 24,
      "execution_expires_after": 172800
    }
  }
}

响应字段说明

id: 视频生成任务的唯一标识符
object: 对象类型（始终为 “video”）
created: 创建时的 Unix 时间戳
model: 用于生成的模型名称
status: 处理状态（“processing” 处理中, “completed” 已完成, “failed” 失败）
url: 生成视频的下载链接（可用时提供）
duration: 实际视频时长（秒）
resolution: 实际视频分辨率

注意事项

示例中使用的 API 密钥仅供演示。
支持的分辨率可能因模型而异。
最大时长限制因模型而异。
图片和音频 URL 必须是公开可访问的。
处理时间取决于视频长度、分辨率和服务器负载。
使用首尾帧模式（frame_mode=first-last）时，first_image 与 last_image 必须同时提供，且建议两张图片的宽高比与 ratio 一致。

概览

标准接口

特殊接口

帮助中心

隐私条款

概述

环境地址

API 接口

1. 提交视频生成任务

认证

案例说明

案例 A：图 + 文

案例 B：图 + 视频 + 文

案例 C：图 + 音频 + 文

案例 D：图 + 视频 + 音频 + 文

案例 E：首尾帧 + 文

请求参数详解

model (模型)

prompt (提示词)

images (参考图)

duration (时长)

resolution (分辨率)

ratio (画面比例)

metadata (元数据)

metadata.referenceVideoUrls (参考视频)

metadata.referenceAudioUrls (参考音频)

metadata.generate_audio (音频生成开关)

metadata.frame_mode (帧模式)

metadata.first_image (首帧图片)

metadata.last_image (末帧图片)

响应示例

提交任务响应示例

2. 查询视频生成任务状态

调用示例

查询任务状态示例

查询任务响应示例

响应字段说明

注意事项

​概述

​环境地址

​API 接口

​1. 提交视频生成任务

认证

案例说明

案例 A：图 + 文

案例 B：图 + 视频 + 文

案例 C：图 + 音频 + 文

案例 D：图 + 视频 + 音频 + 文

案例 E：首尾帧 + 文

请求参数详解

model (模型)

prompt (提示词)

images (参考图)

duration (时长)

resolution (分辨率)

ratio (画面比例)

metadata (元数据)

metadata.referenceVideoUrls (参考视频)

metadata.referenceAudioUrls (参考音频)

metadata.generate_audio (音频生成开关)

metadata.frame_mode (帧模式)

metadata.first_image (首帧图片)

metadata.last_image (末帧图片)

响应示例

提交任务响应示例

​2. 查询视频生成任务状态

调用示例

查询任务状态示例

查询任务响应示例

响应字段说明

​注意事项

概述

环境地址

API 接口

1. 提交视频生成任务

2. 查询视频生成任务状态

注意事项