创建视频（Seedance）

该系列支持OpenAI视频生成格式（详见链接 视频生成Sora兼容格式）。

用于创建视频生成任务，并通过任务 ID 查询状态与结果。

创建任务核心字段：

• model：必填，模型名称。
• prompt：必填，视频生成主描述。
• content：可选，火山方舟 content 数组，混排文本、图片、视频、音频素材。
• function_mode：可选，常用于全能参考等高级模式。

兼容入参：

以下字段主要用于历史客户端和旧协议适配。新接入请尽量采用本页“请求示例”中的标准格式：文本与参考素材使用 content 数组，生成配置使用顶层 duration、ratio、resolution、fps 等字段。

• mode：t2v / i2v / i2v_first_last / reference_images / reference_material
• image_url / image_urls / input_reference
• end_image_url / last_image_url
• video_urls / audio_urls
• seconds / duration
• aspect_ratio / ratio / size
• quality / resolution
• fps
• generate_audio / watermark

调用细节：

• 当 mode=reference_material 或 function_mode=omni_reference 时，建议通过 content 传递文本与参考素材。
• content 文本项写法为 { "type": "text", "text": "测试文字" }。
• content 图片、视频、音频素材项分别使用 image_url、video_url、audio_url 对象写法，例如 { "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }。
• role 可标识素材用途，name 可供提示词中按名称引用。
• ratio、duration、resolution、fps 会影响最终生成配置。

Gemini Omni 调用：

• gemini-omni 也可通过本 Seedance 任务接口调用。
• mode=t2v 用于文生视频，mode=r2v 用于参考图/参考素材生成，mode=edit 用于视频编辑。
• 文本可放在 prompt 或 content 的 text 项；图片可放在 image_url / image_urls / reference_images / input_reference / content；视频可放在 video_urls / content。
• 时长字段可用 duration 或 seconds，会自动匹配到 4 / 6 / 8 / 10 秒档。

MiniMax / Hailuo 调用：

• minimax-h3 可通过本任务接口调用，支持文生视频、图片参考和音频参考；文本可放在 prompt 或 content 文本项，素材可放在 content、image_urls、audio_urls 等字段。
• hailuo-2.3 可通过本任务接口调用，需要首帧图片，建议在 content 中传 role=first_frame 的 image_url 项。
• minimax-h3 常用 duration=5~15、resolution=1440p；hailuo-2.3 常用 duration=6 或 10、resolution=768p。

查询结果关注字段：

• items[].status
• items[].content.video_url 或 items[].video_url
• items[].error
• items[].progress

Error fields: error.code, error.message.

{
  "error": {
    "code": "invalid_request_error",
    "message": "requires at least one image in `images`"
  }
}