動画生成とアセット管理

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}
  • アセット登録:必須の 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 非同期タスク契約を提供します。