建立影片（Seedance）

此系列支援OpenAI影片生成格式（詳見連結 影片生成Sora相容格式）。

用於建立影片生成任務，並透過任務 ID 查詢狀態與結果。

建立任務核心欄位：

• model：必填，模型名稱。
• prompt：選填；未傳入時，須在 content 中提供非空文字項。
• 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 會影響最終生成配置。

Seedance 2.5 圖片、影片、音訊混合參考範例（素材 URL 為佔位符，呼叫時請替換為實際可存取的連結）：

{
  "model": "sd-2-5",
  "ratio": "9:16",
  "fps": 24,
  "duration": 10,
  "content": [
    {
      "type": "text",
      "text": "使用 @图片1 @图片2 @图片3 @音频1 参考@视频1 生成视频"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://demo1.png"
      },
      "role": "reference_image",
      "name": "图片1"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://demo2.png"
      },
      "role": "reference_image",
      "name": "图片2"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://demo3.png"
      },
      "role": "reference_image",
      "name": "图片3"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://video.mp4"
      },
      "role": "reference_video",
      "name": "视频1"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://audio.mp3"
      },
      "role": "reference_audio",
      "name": "音频1"
    }
  ]
}

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`"
  }
}

Kling 4.0

Kling 4.0 呼叫：kling-4.0（720p）與 kling-4.0-1080p 同時支援 Seedance content/duration/resolution/ratio/mode 格式、contents/settings/options 與 OpenAI 視訊格式；兩種統一視訊入口可重複使用請求主體。解析度須與模型名稱一致。Kling 4.0 可直接使用 Seedance 格式 content/duration/resolution/ratio/mode，或 OpenAI 視訊格式 prompt/seconds/size/input_reference；兩者皆無需額外的 contents/settings/options。舊版 contents/settings/options 信封僅供相容。mode 可選 t2v（純文字）、i2v（單張首幀）、i2v_first_last（首尾兩幀）、reference_images（一般參考圖）、reference_material（圖片或視訊參考）。省略 mode 且沒有明確工具時，有參考素材時預設為 reference_material，沒有任何參考素材時預設為 t2v。參考模式使用一般參考圖角色，不會將明確的首尾幀靜默改為參考圖；首尾幀請明確選擇 i2v 或 i2v_first_last，並省略畫幅參數。目前不支援參考音訊。settings.audio 僅圖片參考／參考素材的全能模式可選；t2v、i2v、i2v_first_last 請省略音訊開關。

Vidu Q4

Vidu Q4：vidu-q4 固定為 720p，vidu-q4-540p 固定為 540p，支援生成 3～16 秒影片。至少需要 1 張圖片，最多支援 15 張參考圖；參考生成可附帶最多 3 段 MP3 音訊，每段 3～12 秒、最大 50MB。不支援純文字生成、指定首尾影格或參考影片。多張圖片用於共同參考，不代表首尾位置。可透過 POST /v1/videos、POST /api/v3/contents/generations/tasks，或 Vidu 格式 POST /ent/v2/img2video、POST /ent/v2/reference2video 建立任務。建議統一入口使用 mode=reference_images；附帶音訊時使用 mode=reference_material。參考音訊可使用 audio_urls，Seedance 格式也可使用標準 content 的 audio_url 項；audio 布林欄位表示生成音訊開關，與參考音訊 URL 清單分別使用。解析度須與模型名稱一致。