豆包 Seedance 视频生成
Seedance 2.5 支持文生视频、首帧/首尾帧图生视频，以及图片、视频和音频的多模态参考。任务采用异步模式：先创建任务，再使用任务 ID 查询结果。模型与规格
Seedance 2.5 默认使用 720p。建议显式传入
duration 和 resolution，以便调用结果与费用预估保持一致。1080p 与 480p/720p 使用不同计费档位，请以 GET /v1/models 返回的当前价格规则为准。
能力范围依据火山引擎 Seedance 2.5 官方文档整理；厂商能力和价格可能调整，调用前请同时核对模型列表。
创建任务
所有模型参数均位于请求顶层。下面的请求生成一段 5 秒、720p、带声音的视频，并要求在查询结果中返回尾帧图片。cURL
首尾帧图生视频
使用role 区分首帧和尾帧，ratio 使用 adaptive。图片 URL 必须能够被模型服务访问；建议首尾帧画幅一致，否则尾帧可能被拉伸。
多模态参考
参考素材使用reference_image、reference_video 和 reference_audio 角色。提示词可用“图片 1”“视频 1”“音频 1”等自然语言指代对应素材。
视频参考与输出比例
Seedance 2.5 的参考生视频支持图片＋视频组合输入，并可指定与参考视频不同的输出比例。上例可将ratio 改为 9:16，以参考视频的运镜生成竖屏视频。图片须使用 reference_image，视频须使用 reference_video；first_frame / last_frame 属于首帧 / 首尾帧任务，适用不同的比例限制。
建议参考生视频显式设置
omni_reference_task_type: reference，并在提示词中说明参考素材的外观、动作或运镜。若提示词实际要求编辑或延长原视频，即使设置为 reference，厂商仍可能返回任务类型不匹配错误。auto 会由模型判断任务类型，不意味着所有带参考视频的请求都能自由修改比例。
Seedance 2.5 也支持仅音频参考、视频编辑和多轮视频延长，以及 tools: [{"type":"web_search"}] 联网搜索。素材总数量上限为 50 个（30 张图片、10 个视频、10 个音频）。1080p 输出为 10bit 位深，480p / 720p 为 8bit；专业后期场景可使用 output_format: mov。
任务类型及比例规则见官方创建视频生成任务 API，能力说明见Seedance 2.5 教程。
纯音频参考
Seedance 2.5 可以仅使用音频作为参考，无需搭配图片或视频；Seedance 2.0 系列仍需要至少一张参考图片或一段参考视频。下面的请求根据音乐节奏生成新视频。视频编辑
编辑任务使用reference_video 输入原视频，通过提示词说明要增加、删除或修改的内容。必须使用 ratio: adaptive、duration: -1；待编辑视频为 4～30 秒。模型保持原视频的比例与近似时长，输出可能略短于原视频，误差不超过 0.4 秒。建议输入和输出都采用 MOV，以保持声画衔接和色彩一致性。
视频延长
通过提示词指定向前或向后延长。ratio 必须为 adaptive，duration 可以设置为 4～30 秒或 -1，控制本次生成的输出时长。输入多个视频时，应在提示词中明确待延长视频。
video_url.url；每轮仍须满足参考视频的时长与素材总时长限制。需要保留完整长片时，可在应用侧保存各轮产物并拼接。
联网搜索
通过tools 开启联网搜索后，模型会根据提示词判断是否搜索，不保证每次调用都执行搜索，且可能增加生成时延。查询结果中的 usage.tool_usage.web_search 表示实际搜索次数，值为 0 表示没有搜索。
POST /v1/videos，鉴权与查询方式同前文。示例中的 example.com 为占位地址，请替换为模型服务可访问的素材 URL。能力和任务限制依据官方 Seedance 2.5 教程及创建接口。
样片模式
Seedance 2.5 支持先生成低分辨率样片，再生成高质量正式视频。两步均使用POST /v1/videos，各自返回一个任务 ID，通过查询任务接口获取结果。
第一步：开启 draft，生成 480p 样片。
draft_task.id，生成 1080p 正式视频。
- 正式视频须使用与样片相同的厂商模型；
draft省略或设为false，resolution必须为1080p。 - 正式视频请求不得再传提示词、参考图片 / 视频 / 音频、
duration、ratio、seed、generate_audio或omni_reference_task_type；这些参数由样片自动复用。不要附加会映射出时长或比例的seconds/size。 return_last_frame、output_format、watermark、service_tier、execution_expires_after、priority、callback_url、safety_identifier可重新指定；省略时使用模型默认值，不继承样片的设置，且仍须满足该模型的参数限制。- 样片任务 ID 从
created_at起有效 7 天。样片与正式视频独立计费，分别按 480p 和目标分辨率计费；正式视频的输入视频计费依据样片阶段的原始输入视频，样片本身不计入输入视频时长。
自由比例与提示词控制
通过素材保持非标准比例
ratio 的直接取值仍是前文列出的六档比例或 adaptive。Seedance 2.5 可通过输入素材配合 adaptive 保持宽高比在 [0.4, 2.5] 范围内的非标准画幅。例如，对 7:5 的首帧图片使用首帧生成，或编辑、延长 7:5 的视频时，设置 ratio: adaptive，输出跟随对应素材的比例。不要直接传 ratio: "7:5"。
普通参考生视频的 adaptive 会根据提示词在六档比例中选择，不表示必然保留任意参考素材的画幅。
整数秒时间戳与多视图参考
Seedance 2.5 支持在提示词中按整数秒描述剧情、动作和转场。时间区间应连续，并与duration 对齐，例如生成 10 秒视频时可以写：
reference_image，并在提示词中明确各图片属于同一主体。涉及多个主体时，优先将不同视角拆成独立图片，减少混淆；所有图片仍计入素材数量上限。
说明与建议见官方 Seedance 2.5 提示词指南。
素材要求
下表适用于 Seedance 2.5 的输入素材；输入视频可为 4K，不代表模型支持 4K 输出。
图片和视频的宽高比需在
[0.4, 2.5]，宽、高各为 300～6000 像素；视频总像素数须在 [407696, 8295044]，帧率为 24～60 fps。MP4 视频支持 H.264 / H.265 编码和 AAC / MP3 音频；MOV 还支持 PCM 音频。
图片、音频可在对应的 url 字段使用 Base64 data URL，例如 data:image/png;base64,...、data:audio/wav;base64,...；请求体不超过 64 MB，大素材优先使用公网 URL。视频使用公网 URL。厂商素材 ID 的可用范围与账号有关，使用前需确认路由账号能访问该素材。
格式与限制依据官方输入素材要求，调用前请确认链接可访问且素材满足要求。
查询任务
cURL
in_queue、in_progress、completed、failed 和 expired。成功响应示例：
expired 表示任务超过执行有效期，不能再继续处理，应重新创建任务。
查询返回的 duration 是视频时长的整数秒约数，计算为总帧数除以 24 后向下取整。例如 133 帧的视频实际约 5.54 秒，返回 duration: 5；精确时长应读取视频文件元数据。实际 token 消耗以返回的 usage.completion_tokens 为准，不能仅凭整数秒时长推断精确费用。参见官方时长返回说明。
常用参数
查询接口返回的下载 URL 可能有有效期。任务成功后请及时下载并保存视频；应用侧轮询时建议采用递增间隔，避免高频请求。