| name | seedance1.5-api |
| description | Seedance 1.5/1.0 系列视频生成 API 文档（火山方舟平台）。用于通过 API 调用 Seedance 模型实现文生视频、图生视频（首帧/首尾帧/参考图）、有声视频生成等功能，包含完整的请求参数、SDK 示例、提示词技巧和错误码参考。 |
Seedance 1.5 API Skill
Seedance 是字节跳动豆包大模型团队推出的视频生成基础模型系列，通过火山方舟（Volcano Ark）平台提供 API 服务。本技能涵盖 Seedance 1.5 pro、1.0 pro、1.0 pro fast、1.0 lite 全系列模型的视频生成 API 使用方法。
注意: Seedance 2.0 目前仅支持控制台体验中心体验，暂不支持 API 调用。
When to Use This Skill
This skill should be triggered when:
- 调用 Seedance API 生成视频（文生视频、图生视频）
- 使用火山方舟平台的视频生成 API
- 需要了解 Seedance 模型的参数配置（分辨率、宽高比、时长等）
- 编写 Seedance 视频生成的提示词（prompt）
- 使用 Python/Go/Java SDK 调用 Seedance
- 处理视频生成任务的创建、查询、取消
- 调试 Seedance API 的错误码
Quick Reference
API Base URL
https://ark.cn-beijing.volces.com/api/v3
鉴权方式
Authorization: Bearer $ARK_API_KEY
模型 ID 列表
| 模型 | Model ID | 能力 |
|---|
| Seedance 1.5 pro | doubao-seedance-1-5-pro-251215 | 文生视频、首帧图生视频、首尾帧图生视频、有声视频、样片模式 |
| Seedance 1.0 pro | doubao-seedance-1-0-pro-250528 | 文生视频、首帧图生视频、首尾帧图生视频 |
| Seedance 1.0 pro fast | doubao-seedance-1-0-pro-fast-250528 | 文生视频、首帧图生视频 |
| Seedance 1.0 lite t2v | doubao-seedance-1-0-lite-t2v | 文生视频 |
| Seedance 1.0 lite i2v | doubao-seedance-1-0-lite-i2v | 首帧/首尾帧/参考图(1-4张)图生视频 |
核心 API 端点
| 操作 | 方法 | 端点 |
|---|
| 创建视频生成任务 | POST | /contents/generations/tasks |
| 查询视频生成任务 | GET | /contents/generations/tasks/{id} |
| 查询任务列表 | GET | /contents/generations/tasks?page_num=&page_size=&filter.status= |
| 取消/删除任务 | DELETE | /contents/generations/tasks/{id} |
快速开始 - 文生视频（curl）
curl -X POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{
"type": "text",
"text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠"
}
],
"ratio": "16:9",
"duration": 5,
"resolution": "720p",
"watermark": false
}'
快速开始 - 图生视频（首帧）
curl -X POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{"type": "text", "text": "老人缓缓戴上眼镜，微笑"},
{
"type": "image_url",
"image_url": {"url": "https://example.com/image.jpg"},
"role": "first_frame"
}
],
"ratio": "16:9",
"duration": 5
}'
快速开始 - 有声视频（Seedance 1.5 pro）
curl -X POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{
"type": "text",
"text": "男人叫住女人说：\"你记住，以后不可以用手指指月亮。\""
}
],
"generate_audio": true,
"ratio": "16:9",
"duration": 5
}'
查询任务状态
curl -X GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/cgt-2025xxxx \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY"
Python SDK 示例
import os
from volcenginesdkarkruntime import Ark
client = Ark(
api_key=os.environ.get("ARK_API_KEY"),
base_url="https://ark.cn-beijing.volces.com/api/v3",
timeout=1800,
)
task = client.content.generations.tasks.create(
model="doubao-seedance-1-5-pro-251215",
content=[{"type": "text", "text": "一只小猫对着镜头打哈欠"}],
ratio="16:9",
duration=5,
)
print(f"Task ID: {task.id}")
result = client.content.generations.tasks.get(task.id)
print(f"Status: {result.status}")
if result.status == "succeeded":
print(f"Video URL: {result.content.video_url}")
视频参数速查
| 参数 | 取值 | 默认值 | 说明 |
|---|
resolution | 480p / 720p / 1080p | 1.5pro/lite: 720p, 1.0pro: 1080p | 分辨率 |
ratio | 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive | 文生: 16:9, 图生: adaptive | 宽高比 |
duration | 2~12 秒（1.5pro 支持 -1 自动） | 5 | 视频时长 |
seed | -1 ~ 2^32-1 | -1 (随机) | 随机种子 |
camera_fixed | true / false | false | 固定摄像头 |
watermark | true / false | false | 水印 |
generate_audio | true / false | true | 有声视频(仅1.5pro) |
draft | true / false | false | 样片模式(仅1.5pro) |
service_tier | default / flex | default | flex为离线模式,半价 |
References
api-create-task.md - 创建视频生成任务 API 完整参数说明api-query-task.md - 查询视频生成任务 APIapi-query-task-list.md - 查询视频生成任务列表 APIapi-cancel-delete-task.md - 取消或删除视频生成任务 APIauthentication.md - Base URL、鉴权方式和 API Key 配置sdk-examples.md - Python/Go/Java SDK 使用示例openai-sdk-compat.md - 兼容 OpenAI SDK 调用方式prompt-guide.md - Seedance 提示词使用技巧error-codes.md - 错误码参考
