Seedance 2.0 API 快速开始：从密钥到第一个视频任务

火山方舟为 Seedance 2.0 系列提供了完整的 Video Generation API 与新手一键环境包。本页按官方教程浓缩出最短路径。

准备工作

1. 注册并登录火山引擎账号。
2. 创建 API Key：在方舟控制台的 API Key 管理页创建并妥善保存，配置为环境变量 ARK_API_KEY。
3. 开通模型：确认账户余额大于 200 元，或已持有余量资源包（见API 计费），否则无法开通。

路径一：官方一键环境包（推荐新手）

官方提供了 quickstart 压缩包，解压后：

• Windows：进入 scripts/init_dev_env 目录，双击 setup_windows.bat——脚本自动下载 uv、Python 3.12，创建虚拟环境并安装方舟 SDK，生成 run_demo.bat，双击即运行示例。
• macOS：终端执行 ./setup_mac.sh 完成配置，运行 ./run_demo.sh。

示例脚本会校验 API Key、在浏览器弹出素材预览页、创建异步任务并每 30 秒打印一次状态，成功后输出视频链接。

路径二：手动安装 SDK

import os, time
from arkruntime import Ark

client = Ark(api_key=os.environ.get("ARK_API_KEY"))

task = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[{"type": "text", "text": "你的提示词"}],
    generate_audio=True,
    ratio="16:9",
    duration=5,
)

while True:
    result = client.content_generation.tasks.get(task_id=task.id)
    if result.status in ("succeeded", "failed"):
        print(result)
        break
    time.sleep(30)

要点：SDK 安装命令为 python -m pip install --upgrade arkruntime；官方另有 Java 与 Go 运行时。

参考素材怎么传

• API 请求的 content 数组里，文本、图片、视频、音频并列放置，各自声明类型与角色（reference_image、reference_video、reference_audio）。
• 素材链接必须是公网可公开访问的地址，官方建议存放在 TOS 对象存储并配置公共读。
• 在提示词文本中用"图片1""视频2"等编号指代素材岗位，与站内 @指代逻辑一致。

官方文档导航

• Seedance 2.0 系列教程：能力详解与各场景示例代码。
• 提示词指南：指令公式与多模态参考技巧（本站提示词组即整理自该文档）。
• 视频生成 API 文档：任务创建、查询、参数与错误码。

步骤整理自火山引擎官方《Doubao Seedance 2.0 系列教程》，接口细节以官方文档最新版为准。