Seedance 视频生成 API 接入文档

适用范围: 通过本平台 (https://www.dianlitoken.com 或代理商域名) 调用 Seedance 系列视频生成模型。
更新时间: 2026-05-27

文档目录

序号	主题	适用人群
01 快速开始	第一次接入,5 分钟跑通	所有开发者
02 创建任务	完整参数 / 模型 / 边界	后端开发
03 查询任务	轮询 / 状态机 / 视频下载	后端开发
04 回调 (Webhook)	任务完成自动通知	后端开发
05 素材库	上传 / 引用素材 (image / video / audio)	高级用户
06 真人认证 (Visual Validate)	人脸识别 / 个性化视频	高级用户
07 计费	价格公式 / 预扣 / 退款 / 加价	商务 / 财务
08 错误码与边界	全部错误码 / 限制 / 内容审核	所有开发者

模型一览

模型名	用途	分辨率	时长	价格水平
`seedance-2.0-pro`	文生视频 (Pro)	480p / 720p / 1080p	4-15s	高
`seedance-2.0-pro-v2v`	视频参考生成 (Pro)	同上	同上	高
`seedance-2.0-fast`	文生视频 (Fast)	480p / 720p	4-15s	低
`seedance-2.0-fast-v2v`	视频参考生成 (Fast)	同上	同上	低

Fast 模型不支持 1080p。请求 1080p + Fast 会返回 400 错误。

API 兼容三种格式

本平台同时支持 三种主流 API 协议, 你用哪种 SDK 都可以:

风格	创建任务	查询任务
OpenAI 风格	`POST /v1/videos`	`GET /v1/videos/{task_id}`
Volcengine 风格	`POST /api/v3/contents/generations/tasks`	`GET /api/v3/contents/generations/tasks/{task_id}`

请求参数体一致, 响应字段位置和 status 枚举随路由变化:

OpenAI 风格: 视频 URL 在 metadata.url, status 用 queued/in_progress/completed/failed
Volcengine 风格: 视频 URL 在 content.video_url, status 用 queued/running/succeeded/failed/expired/cancelled(6 枚举完整保留), 顶层带 usage / seed / duration 等

新接入推荐使用 OpenAI 风格 — 跟 chat completions 一致, SDK 现成。

认证

所有 API 通过 Bearer Token 认证。

http

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

Token 在 用户中心 → API Keys 页面创建。

调用流程概览

┌──────────────────────────────────────────────────────────┐
│                     调用者 (你的程序)                          │
└─────────────┬────────────────────────────────────────────┘
              │
              │ 1. POST /v1/videos
              │    Authorization: Bearer sk-xxx
              │    {"model": "seedance-2.0-fast", "content": [...]}
              │
              ▼
┌──────────────────────────────────────────────────────────┐
│                  本平台 (www.dianlitoken.com)                  │
│  - 鉴权 + 预扣费                                            │
│  - 转发到 上游官方                                       │
│  - 返回 task_id                                            │
└─────────────┬────────────────────────────────────────────┘
              │
              │ 2. 立即返回 {"id": "cgt-xxx", "status": "queued"}
              │
              ▼
              ┌──── 调用者两种方式拿结果: ──────────────┐
              │                                       │
        方案 A 轮询                              方案 B 回调
              │                                       │
              ▼                                       ▼
   GET /v1/videos/cgt-xxx         (任务完成时) 官方 → callback_url
   每 10s 查一次, 直到                 (POST 任务对象到 callback_url)
   status == "completed"
              │                                       │
              └─────────────┬─────────────────────────┘
                            │
                            ▼
                  3. 从 metadata.url 拿视频地址, 下载/转存
                     (URL 24 小时内有效, 过期需重新生成)

计费简介(详见 07-pricing.md)

预扣费: 提交任务时立即扣除预估额度(按 max duration / resolution)
结算: 任务完成时按实际 token 数 / duration 重新计算, 多退少补
失败退款: 任务 failed / cancelled / expired 全额退款
代理商加价: 代理商可在自己的 group_ratio 上加 ≥1.05 倍

接入对照表

你来自	推荐迁移路径
Volcengine 即梦官方 SDK 用户	把上游 base URL 替换成 `https://www.dianlitoken.com`,继续用 `/api/v3/contents/generations/tasks` 路径,几乎零迁移
其他第三方网关 SDK 用户	改 base URL + 改 key 即可
新接入用户	推荐用 OpenAI 风格 `/v1/videos`,SDK 多

关键限制(一定要看)

限制	数值	说明
单任务最大时长	15 秒	超过会返 400
视频 URL 有效期	24 小时	过期后必须重新生成任务
Token rate limit	每 token 默认配置	看你的 token 设置
并发任务数	无显式限制	受预扣额度限制
内容审核	上游官方审核	违规 prompt 会被拒,扣费会退回

客户支持

邮箱: (按代理商配置)
文档反馈: GitHub Issues
紧急联系: 看你代理商的"联系邮箱"

接下来去看 01 快速开始 →

Seedance 视频生成 API 接入文档 ​

文档目录 ​

模型一览 ​

API 兼容三种格式 ​

认证 ​

调用流程概览 ​

计费简介(详见 07-pricing.md) ​

接入对照表 ​

关键限制(一定要看) ​

客户支持 ​

Seedance 视频生成 API 接入文档

文档目录

模型一览

API 兼容三种格式

认证

调用流程概览

计费简介(详见 07-pricing.md)

接入对照表

关键限制(一定要看)

客户支持