Seedance 2.0 创建视频生成任务 API 文档
1. 接口说明
用于创建 Seedance 2.0 视频生成任务。2. 请求结构
请求体为 JSON 对象，基础字段放在顶层，时长、比例、分辨率、音频、水印、随机种子、固定镜头、多模态素材等参数放在metadata 内。
duration、ratio、resolution、generate_audio、watermark、seed、return_last_frame、camera_fixed、content 必须放在 metadata 内。
3. 场景互斥规则
Seedance 2.0 的图片输入分为三类角色场景。以下三种场景不能在同一个请求中混用。
多模态参考场景还可以同时包含参考视频和参考音频。
在多模态参考模式下，
reference_image、video_url、audio_url 可以任意组合同时使用。
禁止混用示例：
4. 顶层参数
可用模型：
5. metadata 参数
6. 请求示例
6.1 文生视频
6.2 图生视频：首帧
image 即可。不要与 video、videos 或包含 video_url 的 metadata.content 同时传入。
6.3 图生视频：首尾帧
images 传 2 张图时，网关会自动分配 first_frame 和 last_frame。该示例为纯图片输入，不能与 video、videos 或 metadata.content 中的 video_url 混用。
6.4 视频参考
videos 数组传入多个参考视频，最多 3 个。还可以通过 metadata.content 传入仅包含 video_url 的素材项。该示例为纯视频参考，请求中不得再出现 image、images 或 metadata.content 中的 image_url。
6.5 多模态参考：参考图 + 参考视频 + 参考音频
reference_image、video_url、audio_url 可以任意组合。不要在同一请求中再传入 first_frame 或 last_frame。
7. 图片模式
图片输入适用于顶层image、顶层 images，或 metadata.content 中仅包含 image_url 的请求。
图片模式与视频参考互斥，不可与顶层 video、顶层 videos 或 metadata.content 中的 video_url 混用，除非该请求明确处于多模态参考模式且图片角色为 reference_image。
使用图片时，
ratio 建议设置为 adaptive，以自适应图片宽高比。
8. 视频参考
Seedance 2.0 支持以参考视频驱动生成。推荐通过顶层video 或 videos 传入，也可以通过 metadata.content 中的 video_url 项传入。
视频参考属于多模态参考模式。在该模式下，reference_image、video_url、audio_url 可以任意组合同时使用。但不能与首帧或首尾帧场景混用，即不能同时包含 first_frame / last_frame 和 video_url。
视频参考素材要求：
9. 宽高比
10. ContentItem 格式
10.1 参考图片
10.2 参考视频
10.3 参考音频
11. 快速校验清单
提交请求前建议确认：model和prompt已填写。duration、ratio、resolution等生成参数放在metadata内。- 顶层
image/images没有和顶层video/videos混用。 - 首帧或首尾帧场景没有和
video_url/audio_url混用。 - 多模态参考模式中图片角色使用
reference_image。 videos数量不超过 3 个。- 参考视频格式为 MP4 或 MOV，单片时长为 2-15 秒，分辨率为 480p-720p。