1080p 输出,并支持 output_format 和 omni_reference_task_type。从 Seedance 2.0 迁移时,需重新检查素材数量、任务类型及 ratio / duration 限制。
想先在浏览器里体验?打开 API 参考 → 创建视频生成任务,填入你的
sk- API Key 即可试一试在线发起真实请求。代码示例
请求参数速查
POST /api/v3/contents/generations/tasks,请求头 Authorization: Bearer sk-...。
输出格式与任务类型参数
这两个参数仅适用于 Seedance 2.5,平台透传至上游;省略时不额外填值,由上游应用默认值。切换为 Seedance 2.0 或其他不支持的模型时应移除。omni_reference_task_type 只用于全模态参考,文生视频、首帧 / 首尾帧任务不需要设置。auto 由模型按素材和提示词判断任务类型;显式设置 reference / edit / extend 时,上游会在提交阶段提前校验对应参数,但实际意图与指定类型不一致时仍可能异步失败。
content 数组
每个元素为一个内容项,type 决定其结构:
素材要求
- 图片和视频的宽高比均为
[0.4, 2.5],宽、高均为[300, 6000]像素,均包含边界值。 - 输入视频支持
480p/720p/1080p/4k,总像素数(宽 × 高)须在[407696, 8295044],帧率为[24, 60]FPS。支持 4k 输入不代表支持 4k 输出。 - 请求体不超过 64 MB;图片和音频可使用 Base64 data URI,大文件应使用 URL 或素材 ID;视频不支持 Base64。
修改文件扩展名不会改变实际编码。含真人人脸的图片或视频不能直接上传作为参考素材;授权真人素材需先走 素材库 与 真人认证,再以
asset:// 引用。
生成模式
首帧、首尾帧、多模态参考是互斥场景:不能把
first_frame / last_frame 与参考图、参考视频或参考音频混用。多模态参考中可通过提示词描述首尾画面;如需严格约束首尾帧,应使用首尾帧模式。
任务类型与参数约束
编辑任务的实际成片可能为非整数秒,可能比待编辑视频略短(官方说明误差约 0.4 秒)。提示词应明确说明生成新视频、编辑现有视频,或向前 / 向后延长,避免模型判定的任务类型与参数配置冲突。
例如,编辑一段 4–30 秒参考视频并输出 MOV,向创建任务接口提交以下 JSON:
编辑视频并输出 MOV
extend,在提示词中明确向前或向后延长;仍使用 ratio: adaptive,duration 可为 -1 或 4–30 秒整数。
输出格式与编码
通过output_format 选择输出容器;这不是直接指定 H.264 / H.265 的编码参数。显式请求 mov 时,平台保留上游原生规格产物,容器、色度采样与音频编码保持不变。默认或显式请求 mp4 的任务按平台默认交付策略处理。
以下为官方原始产物规格;MP4 产物请以下载文件的实际媒体信息为准。
官方分别列出了「1080p:10bit / H.265」和「MOV:H.264 / yuv444p / PCM」的说明,未在该接口文档中明确
1080p + mov 组合的位深与编码优先规则,因此不能把所有 MOV 都写成 H.265,也不能仅凭扩展名推断位深。需要特定规格时,请检查实际文件的媒体信息。查询任务
GET /api/v3/contents/generations/tasks/{task_id}
任务状态机:queued → running → succeeded / failed / cancelled / expired。任务记录长期保留,可随时回查。
成功响应示例:
output_format 返回上游生成视频的格式(mp4 / mov),单任务查询与任务列表均保留此字段。旧任务或上游未返回时会省略,请勿只凭下载 URL 的后缀判断格式。
查询返回的 duration 为整数秒约数,按「实际总帧数 ÷ 24,向下取整」计算,不保证等于文件的精确时长。例如 133 帧对应约 5.54 秒,接口返回 duration: 5。
usage.total_tokens 为上游按「时长 × 分辨率像素 × 帧率」口径折算的视频 token 数,是结算依据。使用 duration: -1 或 ratio: adaptive 时,以响应中回填的实际值为准。任务列表与取消
本平台提供以下两个任务管理接口(列表参数与保留策略以本平台为准): 列出任务 —GET /api/v3/contents/generations/tasks
响应为
{"items": [...], "total": n},元素结构与查询单个任务一致。
取消/删除任务 — DELETE /api/v3/contents/generations/tasks/{task_id}
排队中的任务可以取消;running 状态的任务不可取消(返回 400 invalid_task_status)。成功返回 {}。
错误响应
所有错误采用与火山引擎一致的结构:429 与 5xx 建议采用指数退避重试(如 2s → 4s → 8s)。参数校验失败(400)与内容审核拒绝(403)均不扣费;已预扣的失败任务会自动退款。
status: failed 时检查 error.code:InvalidParameter.TaskTypeConstraint 表示参数与模型判定的任务类型不兼容;官方显式任务类型与实际意图不一致时则为 InvalidParameter.TaskTypeMismatch。
核对依据
本页模型规格依据火山引擎官方 创建视频生成任务(2026-08-21 更新)与 查询视频生成任务(2026-08-19 更新)的文档快照核对;平台差异单独标明。相关文档
能力总览与定价
模型清单、技术规格、计费规则
素材引用实战
从上传素材到角色一致性生成的完整链路
在线调试
在文档内直接试一试