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 列表

核心 API 端点

快速开始 - 文生视频（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}")

视频参数速查

References

• api-create-task.md - 创建视频生成任务 API 完整参数说明
• api-query-task.md - 查询视频生成任务 API
• api-query-task-list.md - 查询视频生成任务列表 API
• api-cancel-delete-task.md - 取消或删除视频生成任务 API
• authentication.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 - 错误码参考