影片生成與資產管理

使用 Kling v4 與 Seedance 模型生成影片,並引用已授權的媒體資產。

透過原生影片端點提交影片生成任務並管理已授權的媒體資產。

POST/v1/videos

請求體

欄位類型必填說明
promptstring是描述所需影片場景、主體與運鏡手法的提示詞文字。
modelstring否影片模型識別碼,例如 kling-v4 或 doubao-seedance-2-0-260128。
duration_secondsnumber否影片生成長度(秒,正數最高 300 秒,同時相容 duration 別名)。
Additional fieldsobject否影片擴充參數(如 resolution、aspect_ratio、first_frame_url、last_frame_url)透明透傳至底層引擎。

Seedance 授權資產

POST/v1/seedance/assets
GET/v1/seedance/assets/{asset_id}
  • 資產註冊:調用 POST /v1/seedance/assets(operationId: seedance_assets.create)並傳遞包含必填 sourceUrl、assetType(image 或 video)及選填 displayName 的 JSON 載荷。
  • URI 引用:在影格影像 URL 或進階參數中直接使用 asset://{asset_id} 進行跨模態引用。
  • 租戶隔離:授權資產嚴格隔離在租戶當前資產庫中,並在提交前與上游儲存完成權限校驗。

任務狀態與產物下載

GET/v1/videos/{task_id}
  • 狀態輪詢:透過 GET /v1/videos/{task_id}(operationId: legacy_media.video.get)查詢任務即時狀態,支援 queued、submitting、submitted、running、ingesting_artifacts、cancel_requested、completed、failed 及 cancelled 等 9 種狀態。
  • 產物下載:任務成功完成後透過 GET /v1/videos/{task_id}/content 下載影片二進位檔案。
  • Kling v4 支援:完整支援文字生影片、首格圖生影片以及尾格轉場過渡模式。

相容路徑

  • 歷史媒體別名:POST /openai/v1/videos 是 POST /v1/videos 的歷史媒體別名(legacy_media.video.create.alias),遵循相同請求結構。
  • 歷史生成任務路由:POST /v1/videos/generations 接收 CreateVideoGenerationRequest 格式載荷。
  • 統一非同步管道:POST /v1/async-tasks/video-generations 提供標準化的 v4 非同步任務生命週期協定。