0. 接入须知（先看这里）
GET
/docs/v2/overview
1. 基本信息
Authorization: Bearer <你的令牌>application/json（推荐）；需要直接上传本 地文件时用 multipart/form-data2. 可以调用哪些模型
seedance，例如 doubao-seedance-2.0-720p、doubao-seedance-2.0-fast、doubao-seedance-2.0-480p-特价）：支持首尾帧、参考图 / 视频 / 音频、声音、水印、种子等全部字段；prompt、seconds、size、input_reference，加上多数视频接口通用的 aspect_ratio、resolution、reference_images、reference_videos。-480p / -720p / -1080p，图像 -1k / -2k / -4k），清晰度和价格都按模型名的档位，这类模型的 size 只用来确定宽高比。3. 尺寸：两种写法二选一
| 写法 | 字段 | 示例 | 说明 |
|---|---|---|---|
| OpenAI 标准写法 | size | "1280x720" | 宽x高像素 |
| 比例 + 档位 | aspect_ratio + resolution | "16:9" + "720p" | 不用记像素 |
parameter_conflict）。aspect_ratio 和 resolution 可以只传其中一个。size 是实际输出尺寸。4. 图片、视频、音频素材怎么传
| 传法 | 适用 | 说明 |
|---|---|---|
| 公网 URL | 图片、视频、音频 | 必须是 http / https 直链，服务端能直接下 载；不要传需要登录的网页地址或即将过期的临时链接 |
| data URL | 图片（视频、音频也可以，但需平台转存，建议用 URL） | 形如 data:image/png;base64,xxxx；单张建议不超过 10MB，更大的请用 URL 或文件上传 |
| 文件上传 | 图片、视频、音频 | 使用 multipart/form-data 直接上传文件 |
reference_images），也兼容 reference_images[] 这种写法；数字和布尔值按文本传（例如 seconds=5、generate_audio=true）。5. 参数校验规则
missing_required_parameter。invalid_parameter。unsupported_parameter，不会被悄悄忽略。v2 不接受 metadata 等厂商原生透传字段。parameter_conflict。invalid_media。upstream_rejected 并附原因，不扣费。6. 视频任务流程
1.
POST /v2/videos 创建任务，立即返回任务对象（status=queued）。2.
GET /v2/videos/{video_id} 查询一次，直到 status 变为 completed 或 failed。生成通常需要几分钟；超过 30 分钟仍未完成的任务会被判定失败（error.code=timeout）。3.
video_url 下载视频（在 expires_at 之前有效，一般为完成后 24 小时），也可以调用 GET /v2/videos/{video_id}/content 下载。7. 计费
请求参数
无
请求示例代码
返回响应
修改于 2026-10-10 05:00:27