影片生成與資產管理
使用 Kling v4 與 Seedance 模型生成影片,並引用已授權的媒體資產。
透過原生影片端點提交影片生成任務並管理已授權的媒體資產。
POST
/v1/videos請求體
| 欄位 | 類型 | 必填 | 說明 |
|---|---|---|---|
prompt | string | 是 | 描述所需影片場景、主體與運鏡手法的提示詞文字。 |
model | string | 否 | 影片模型識別碼,例如 kling-v4 或 doubao-seedance-2-0-260128。 |
duration_seconds | number | 否 | 影片生成長度(秒,正數最高 300 秒,同時相容 duration 別名)。 |
| Additional fields | object | 否 | 影片擴充參數(如 resolution、aspect_ratio、first_frame_url、last_frame_url)透明透傳至底層引擎。 |
Seedance 授權資產
POST
/v1/seedance/assetsGET
/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 非同步任務生命週期協定。