動画生成とアセット管理
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}- アセット登録:必須の
sourceUrl、assetType(imageまたはvideo)、および任意のdisplayNameを含む JSON を使用してPOST /v1/seedance/assets(operationId: seedance_assets.create)を呼び出します。 - 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 非同期タスク契約を提供します。