Documentation Index
Fetch the complete documentation index at: https://wisdom-docs.juheapi.com/llms.txt
Use this file to discover all available pages before exploring further.
Seedance 2.0（doubao-seedance-2）是豆包推出的视频生成模型，通过文本提示词结合可选的图片和视频参考来创建视频。与使用 multipart/form-data 的 Sora 模型不同，Seedance 2.0 使用 application/json 格式，直接接受图片和视频 URL。
创建后，使用 查询接口 获取生成状态。任务完成后，使用 内容端点 下载视频。
支持的模型
重要说明
异步处理视频生成采用异步模式。创建任务后立即返回任务 ID，您需要使用 查询接口 获取生成进度和结果。 内容政策生成的视频内容必须符合使用政策。禁止生成违法、暴力、色情或侵犯版权的内容。
资源管理请及时下载生成的视频以避免资源过期。查看响应中的 expires_at 字段了解视频过期时间。
快速开始
基础示例：文本生成视频
curl -X POST "https://api.wisgate.ai/v1/videos" \
-H "Authorization: Bearer $WISDOM_GATE_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "一只猫在街上走",
"model": "doubao-seedance-2",
"duration": 4,
"size": "1280x720"
}'
请求参数
请求体（JSON）
| 参数 | 类型 | 必填 | 说明 |
|---|
prompt | string | 是 | 描述待生成视频的文本提示词 |
model | string | 是 | 必须为 doubao-seedance-2 |
duration | integer | 否 | 视频时长（秒）。范围：4-15，默认：4 |
size | string | 否 | 输出分辨率。可选：1280x720、720x1080、1920x1080、1080x1920，默认：1280x720 |
mode | string | 否 | 生成模式。可选：i2v 或 r2v。详见 模式说明 |
images | array[string] | 否 | 图片 URL 数组，作为参考素材 |
videos | array[string] | 否 | 视频 URL 数组，作为参考素材 |
模式说明
i2v 模式（图片生成视频，首尾帧模式）
当 mode 设置为 i2v 且提供了 images 时：
- 数组中的 第一张图片 作为 首帧（必填）
- 第二张图片（如提供）作为 尾帧（选填）
- 生成的视频将从首帧过渡到尾帧
curl -X POST "https://api.wisgate.ai/v1/videos" \
-H "Authorization: Bearer $WISDOM_GATE_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "城市天际线从白天到夜晚的平滑过渡",
"model": "doubao-seedance-2",
"duration": 6,
"size": "1280x720",
"mode": "i2v",
"images": [
"https://example.com/first-frame.jpg",
"https://example.com/last-frame.jpg"
]
}'
r2v 模式（参考生成视频）
当 mode 设置为 r2v 时，所有提供的图片和视频都将作为参考素材来引导视频生成。模型会综合所有参考的视觉信息来创建输出视频。
curl -X POST "https://api.wisgate.ai/v1/videos" \
-H "Authorization: Bearer $WISDOM_GATE_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "参考图1和图2，设计一个带有平滑线条流动和背景光影流动的淡入淡出动画。",
"model": "doubao-seedance-2",
"duration": 4,
"size": "1280x720",
"mode": "r2v",
"images": [
"https://example.com/reference1.jpg",
"https://example.com/reference2.jpg"
],
"videos": [
"https://example.com/reference-video.mp4"
]
}'
完整工作流
第一步：创建视频任务
import requests
url = "https://api.wisgate.ai/v1/videos"
headers = {
"Authorization": "Bearer WISDOM_GATE_KEY",
"Content-Type": "application/json"
}
data = {
"prompt": "一只猫在街上走",
"model": "doubao-seedance-2",
"duration": 5,
"size": "1280x720"
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
video_id = result["id"]
print(f"已创建视频任务: {video_id}")
第二步：轮询状态并下载
使用返回的 id 通过 查询接口 查询状态。当状态为 completed 时，视频下载链接可通过 meta_data.url 获取：
import time
status_url = f"https://api.wisgate.ai/v1/videos/{video_id}"
while True:
response = requests.get(status_url, headers={"Authorization": "Bearer WISDOM_GATE_KEY"})
result = response.json()
status = result["status"]
progress = result.get("progress", 0)
print(f"状态: {status}, 进度: {progress}%")
if status == "completed":
video_url = result["meta_data"]["url"]
print(f"视频 URL: {video_url}")
# 下载视频
video_response = requests.get(video_url, stream=True)
with open("generated_video.mp4", "wb") as f:
for chunk in video_response.iter_content(chunk_size=8192):
f.write(chunk)
print("视频下载成功！")
break
elif status == "failed":
print(f"错误: {result.get('error')}")
break
time.sleep(10)
支持的分辨率
| 尺寸 | 方向 | 说明 |
|---|
1280x720 | 横屏 | 标准 HD（默认） |
720x1080 | 竖屏 | 竖向格式 |
1920x1080 | 横屏 | 全高清 |
1080x1920 | 竖屏 | 竖向全高清 |
最佳实践
1. 提示词优化
使用具体、详细的描述，包含场景、动作和风格：
好的提示词：
金色麦田在日落微风中摇曳的电影航拍镜头，温暖的光线投下长长的阴影，4K 画质
2. 时长选择
根据内容复杂度选择合适的时长：
- 4-6 秒：最适合简单场景，生成最快
- 7-10 秒：适合中等复杂度场景
- 11-15 秒：适合包含多个元素的复杂场景
3. 参考素材质量
使用图片或视频作为参考时：
- 确保 URL 可公开访问
- 每个文件大小不超过 4MB
- 使用高质量、清晰的参考素材以获得最佳效果
- 在
i2v 模式下，确保首帧和尾帧图片的风格和分辨率一致
4. 模式选择
- 当需要精确控制视频的起始帧（和可选的结束帧）时，使用 i2v 模式
- 当希望模型使用多个参考素材作为风格/内容引导时，使用 r2v 模式
常见问题
Seedance 2.0 和 Sora 模型有什么区别？
Seedance 2.0 使用 application/json 格式，直接接受图片和视频 URL；而 Sora 模型使用 multipart/form-data 进行文件上传。Seedance 2.0 还支持首尾帧控制（i2v 模式）和多参考生成（r2v 模式）等独特功能。
参考文件的大小限制是什么？
每张图片和每个视频参考文件必须小于 4MB。
可以提供多少张图片/视频？
i2v 模式下最多提供 2 张图片（首帧必填，尾帧选填）。r2v 模式下可以提供多张图片和视频作为参考。
不提供图片或视频可以使用 Seedance 2.0 吗？
可以。如果不提供 mode、images 或 videos 参数，模型将仅根据文本提示词生成视频（纯文本生成视频）。
