功能与协议选择

Seedance 可以根据文字生成视频，也可以用图片控制首尾画面、用视频和音频作为参考。具体能力取决于模型。三种协议调用的是同一类模型，参数放置位置和返回结构不同。

Base URL：https://top.qingyuntop.ai。

格式创建入口提示词与素材任务查询适合场景
统一视频格式POST /v1/videosprompt + metadata.contentGET /v1/videos/{task_id}已使用 OpenAI Video 风格的任务程序。
Responses 格式POST /v1/responsesinput + metadata.contentGET /v1/responses/{response_id}需要后台任务、同步等待或 SSE。
豆包原生格式POST /doubao/api/v3/contents/generations/taskscontent 数组GET 同一路径/{task_id}使用豆包字段、样片、复杂多模态输入。

统一视频与 Responses 是本站的兼容接口。豆包原生格式沿用火山方舟字段，本站路径增加 /doubao 前缀，任务 ID 使用本站返回值。本目录提供创建和单任务查询，不提供列表、删除或取消；请根据需要选择上表中的请求结构。

第一步：鉴权

在控制台 API 密钥取得青云 API Key。每次创建、查询和下载请求都发送以下请求头：

Authorization: Bearer YOUR_API_KEY

将 YOUR_API_KEY 替换为自己的 Key，保留 Bearer 和其后一个空格。无需先请求登录接口。

第二步：调用模型生成

创建请求返回任务标识后，定时查询；成功再下载。统一和豆包原生接口返回公共 task ID，Responses 返回 resp_… 并在 metadata.task_id 中关联公共 task ID。三种方式均可通过 GET https://top.qingyuntop.ai/v1/videos/{task_id}/content 下载视频。

模型与参数选择

模型 ID时长（秒）分辨率输入及音频
doubao-seedance-2-5-2606284–30，或 -1 智能选择480p、720p、1080p文本、首尾帧、参考图/视频/音频；可生成声音。
doubao-seedance-2-0-2601284–15，或 -1480p、720p、1080p、4k文本、首尾帧、参考图/视频/音频；可生成声音。
doubao-seedance-2-0-fast-2601284–15，或 -1480p、720p2.0 系列输入，可生成声音。
doubao-seedance-2-0-mini-2606154–15，或 -1480p、720p2.0 系列输入，可生成声音。
doubao-seedance-1-5-pro-2512154–12，或 -1480p、720p、1080p文本、首帧、首尾帧；可生成声音；支持样片。
doubao-seedance-1-0-pro-2505282–12480p、720p、1080p文本、首帧、首尾帧；无同步音频。
公开目录核对（2026-10-02）：pricing 快照匹配到以下型号。它不是完整模型清单，也不替代当前 Key 的 GET /v1/models；模型可见性、视频动作和参数组合仍需按本文说明。
公开模型 ID目录协议提示公开分组
doubao-seedance-2-0-260128openaiSeedance
doubao-seedance-2-5-260628openaiSeedance

可用模型以模型价格和当前 Key 的 GET /v1/models 为准，参数含义可参阅官方模型文档。使用旧版 doubao-seedance-1-0-lite-t2v 或 doubao-seedance-1-0-lite-i2v 时，请填写本站返回的完整模型 ID，并按该型号的限制选择参数。

2.5 默认时长为 -1。本文示例显式使用 5 秒、720p，便于控制输出时长；可选时长按上表选择。2.5 首帧/首尾帧、视频编辑及延长必须使用 ratio: adaptive；编辑任务还必须使用 duration: -1。

接入注意事项

统一接口推荐 JSON；multipart 只接受普通字段，不接受图片或视频文件。使用 metadata.content 指定参考素材及角色，使用 seconds 指定正整数秒数。样片转正式视频请使用豆包原生格式，该流程不适用于统一视频创建接口。

创建统一视频任务提供 cURL、Python、Node.js 横向示例；查询和下载提供完整轮询代码。