模型解析页

Doubao Seedream 5 0

模型 ID: doubao-seedream-5-0

厂商: ByteDance能力类型: Image价格: $0.0315 /request更新于: 2026-05-02

Doubao Seedream 5 0 是字节跳动豆包视频生成系列中的 1.0 Pro Fast 版本，面向低延迟与高可控的视频生成场景。本页基于 ToAPIs 官方文档整理参数边界与接入路径，便于从效果验证迁移到生产调用。

在 Playground 中打开文档

模型概览

快速结论

通过 model 可选 fast/quality 两个 1.0 Pro 版本，覆盖速度优先与质量优先需求。
统一入口 POST /v1/videos/generations，支持首帧、尾帧与参考图控制（按版本限制）。
支持异步任务流程，提交后返回任务 ID，再通过任务状态接口轮询结果。

Doubao Seedream 5 0模型特点

核心能力

能力一览与工程实践价值

双版本策略：速度与质量分层

同一接口可选择 doubao-seedance-1-0-pro-fast 或 quality，便于按业务时延目标切换。

首帧/尾帧/参考图精细控制

通过 image_urls 或 image_with_roles 控制视频起止画面与风格参考，提升镜头可控性。

标准化异步任务交付

返回 generation.task 对象并提供状态流转，适合接入队列与批处理工作流。

如何使用 Doubao Seedream 5 0 API

准备 API Key，并在请求头设置 Authorization: Bearer <YOUR_API_KEY>。
向 /v1/videos/generations 发送 POST，请求体传 model、prompt、duration、aspect_ratio、resolution。
如需图像控制，选择 image_urls 或 image_with_roles（二选一）。
提交后获取任务 id，并通过视频任务状态接口轮询至 completed。

适用场景

需要在较短时延内完成短视频生成并快速迭代提示词。
需要通过首帧/尾帧或参考图增强镜头连续性与风格一致性。
需要标准化异步任务状态管理来接入服务端生产流程。

API 运行特性

统一调用 POST /v1/videos/generations，返回任务对象（generation.task）而非直接视频文件。
支持 image_urls 或 image_with_roles，两者互斥，且角色图每种仅支持一张。
quality 版本支持 last_frame；fast 版本不支持首尾帧同时使用。
使用 reference 角色图时，分辨率存在 1080p 限制，需按文档约束降级。

关键参数

参数	类型	必填	默认值	取值范围	说明
model	string	是	doubao-seedance-1-0-pro-fast	doubao-seedance-1-0-pro-fast \| doubao-seedance-1-0-pro-quality	视频生成模型名称；fast 速度优先，quality 质量优先。
prompt	string	是	-	-	视频内容描述，建议明确场景、动作与风格。
duration	integer	否	5	2-12	视频时长（秒）。
aspect_ratio	string	否	16:9	16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| 21:9	视频宽高比。
resolution	string	否	720p	480p \| 720p \| 1080p	视频分辨率；使用 reference 图时存在 1080p 限制。
image_urls	string[]	否	-	-	首帧图像 URL 数组；仅支持 URL，不支持 base64；与 image_with_roles 互斥。
image_with_roles	array	否	-	-	带角色图像数组（first_frame/last_frame/reference）；每种角色仅支持一张。
metadata.seed	integer	否	-	-1 ~ 2^32-1	种子值，用于控制生成随机性。

常见错误

400 invalid_request_error

触发条件: model、prompt 或时长/比例等参数缺失或格式不合法。

修复建议: 按文档校验必填字段与取值范围，重点检查 duration、aspect_ratio、resolution。

重试策略: 修正参数后重试。

401 authentication_error

触发条件: Authorization 缺失、格式错误或 API Key 无效。

修复建议: 确认 Bearer Token 与 API Key 权限。

重试策略: 修复鉴权后重试。

429 rate_limit_exceeded

触发条件: 请求频率、并发或当前额度命中上游限流策略。

修复建议: 先做指数退避重试，并检查当前请求节奏、并发设置和额度使用情况。

重试策略: 建议 1s/2s/4s + 抖动；连续触发时再收紧提交节奏。

FAQ

fast 和 quality 怎么选？

fast 适合快速预览与高频迭代；quality 适合对细节质量和画面稳定性要求更高的生产场景。

为什么我设置 1080p 失败？

使用 reference 角色图时不支持 1080p，请改为 720p 或调整图像控制方式。

首尾帧都能在 fast 里用吗？

不能。last_frame 仅 quality 版本支持，fast 版本不支持首尾帧同时使用。

图像视频模型报错：invalid apitype: -1

这类错误通常说明接口走错了。图像和视频模型一般不走 chat 接口，而是按对应文档发起 HTTP 任务请求，并通过任务状态接口轮询结果。排查时建议先看用户的实际请求代码、请求地址和请求体。

用户进行生成图片/视频的任务时出现任务失败，但是扣款

先让用户提供任务日志或截图，重点看是否出现了输入或输出 token 统计。如果有这类 token 记录，大概率是用户把图片/视频模型走成了 chat 接口；这不是正确用法。图片和视频模型通常是异步任务接口，需要通过 HTTP 请求先提交任务，再拿到任务 ID 轮询状态，详细以对应文档为准。

模式说明

Text to Video 模式（Doubao Seedream 5 0）

纯文本生成视频，适合快速脚本验证与创意打样。

模式参数

modelpromptdurationaspect_ratioresolution

最佳应用场景

广告创意分镜预演
内容脚本快速出片
多版本提示词 AB 测试

Image-guided Video 模式（Doubao Seedream 5 0）

使用首帧、尾帧或参考图增强镜头控制与风格稳定性。