面向开发者的 Seedance 2.0 视频 API 接入指南，覆盖方舟平台开通、API 调用、SDK 示例、TOS 存储与价格注意事项。
面向开发者的 Seedance 2.0 视频 API 接入指南，覆盖方舟平台开通、API 调用、SDK 示例、TOS 存储与价格注意事项。
微信AI开放开发者接入，支持自动模式和开发模式，将小程序转化为AI可调用的Agent技能，零代码即可接入
Seedance 2.0 是火山引擎旗下的视频生成大模型，支持文本、图片、音频、视频四种模态输入，被认为是当前国内可商用的 SOTA（同级别最优）视频生成 API 之一。本指南面向开发者，从零跑通"调用 API 生成第一支视频"的完整链路，包含账号开通、接口调用、结果查询、对象存储配置和成本控制。
模型按任务异步调用：提交任务 → 拿 task_id → 轮询查询状态 → 拿到视频 URL（有效期 24 小时，需及时转存）。
视频生成是异步任务，不要把请求当同步调用处理，否则会卡死客户端。
volc-sk-xxx| 用途 | 链接 |
|---|---|
| 创建视频任务 API 参考 | https://www.volcengine.com/docs/82379/1520757 |
| 查询视频任务 API 参考 | https://www.volcengine.com/docs/82379/1521309 |
| SDK 多语言示例 | https://www.volcengine.com/docs/82379/2298881 |
| 接入流程全指南 | https://www.volcengine.com/article/42393 |
seedance-2.0-xxx），后续调用会用提示：开通审核通常 1-3 个工作日，建议同时申请图生视频、文生视频两个变体。
核心端点（以方舟官方为准）：
POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks
Authorization: Bearer {API_KEY}
Content-Type: application/json请求体示例（文生视频）：
{
"model": "seedance-2.0-text-to-video",
"content": [
{
"type": "text",
"text": "一只柯基在草地上奔跑，慢镜头，阳光逆光"
}
],
"parameters": {
"duration": 5,
"resolution": "720p",
"fps": 24
}
返回示例：
{
"id": "task-xxxxxxxxxxxx"
}把这个 id 记下来。
提示：参数顺序和命名以官方 API 参考为准，模型版本升级时字段可能调整，建议每次接入前对照最新文档。
调用查询接口轮询（建议间隔 10-15 秒，5 秒视频通常 1-3 分钟完成）：
GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{task_id}
Authorization: Bearer {API_KEY}成功返回示例：
{
"id": "task-xxxxxxxxxxxx",
"status": "succeeded",
"content": {
"video_url": "https://ark-video-xxx.volces.com/xxx.mp4"
}
}拿到 video_url 后立即下载——URL 有效期只有 24 小时，且只支持查询最近 7 天的任务记录。
生产环境强烈建议把视频转存到火山引擎 TOS（对象存储），避免 URL 过期：
import requests, tos
# 1. 下载
video = requests.get(video_url).content
# 2. 上传到 TOS
client = tos.TosClientV2(ak, sk, endpoint, region)
client.put_object(Bucket="your-bucket", Key="videos/corgi.mp4", 如果需要走内网加速，可配置 VPC 专属网络环境，进一步降低延迟和公网流量费。
直接写 HTTP 请求要自己处理签名，建议用官方 SDK：
pip install volcengine-python-sdknpm install @volcengine/openapiSDK 已经包好鉴权和重试逻辑，几行代码就能跑通。
成功标志：
queued → running → succeededvideo_url 下载到 mp4 文件建议首次接入用一段简短提示词（5 秒视频）验证全链路，再逐步增加复杂度。
queued：检查账号是否欠费、模型权限是否开通、并发是否打满。video_url 403 / 过期：URL 24 小时过期是设计如此，必须在拿到 URL 后立刻下载或转存 TOS。相关链接