kling-v3-omniモデルでKling 3.0 Omniにアクセスします。必須のプロンプトと開始・終了フレーム、参照画像、または1つの参照動画を組み合わせ、img_uuidで非同期の結果を追跡します。マルチモーダル動画生成のためのKling 3.0 Omni API
GoEnhanceを通じて
APIキーを取得
プロンプト、画像、動画参照のための単一エンドポイント
プロンプト内で参照資料を指定する
画像は開始フレーム、終了フレーム、ref_imgsの順で@image_1から番号が付けられます。参照動画は@video_1となるため、安定した配列順序によりプロンプトの参照が決定論的に保たれます。
機能またはベースの参照動画動作を使用する
video_type: featureの場合、出力は参照動画の動きとスタイルに従います。音声生成は拒否され、マルチショットが強制されます。baseの場合、ソース動画がその場で編集され、開始/終了フレームとマルチショットは使用できず、既存の音声が保持されます。
生成タスクをキューに入れる前に、役割固有の組み合わせを検証します。
Kling 3.0 Omni APIの機能と検証ルール
モデルとプロンプト
必須の<code>model: kling-v3-omni</code>と必須の<code>prompt</code>を指定して、<code>https://api.goenhance.ai/api/v1/videos/generations</code>にPOSTリクエストを送信します。
開始フレームと終了フレーム
開始フレームには<code>image_url</code>を使用します。<code>image_end_url</code>には開始フレームが必須であり、終了フレームのみのリクエストはサポートされていません。
参照画像
順序付けられた<code>ref_imgs</code>値を渡し、<code>@image_N</code>で参照します。互換性のあるエイリアス<code>image_urls</code>も受け入れられます。
参照動画
3〜15.5秒のMP4またはMOVファイルを<code>ref_videos</code>経由で最大1つ渡します。<code>video_url</code>は互換性のあるエイリアスです。
出力制御
3〜15秒の整数秒数、720p/1080p/4K解像度、および開始フレームや参照動画でアスペクト比が指定されていない場合の16:9、9:16、1:1を選択します。
素材の制限
開始フレーム、終了フレーム、参照画像は合計で最大7つまで、参照動画が含まれる場合は最大4つまで使用できます。
料金は生成1秒あたりの単価で、解像度、リファレンス動画の使用有無、ネイティブ音声の有無によって異なります。
Kling 3.0 Omni APIの料金
720p · 動画なし、音声なし
生成1秒あたり4.2トークン（$0.084/秒）。
720p · ネイティブ音声
参照動画がない場合、生成1秒あたり5.6トークン（$0.112/秒）。
720p · 参照動画あり
生成1秒あたり6.3トークン（$0.126/秒）。
1080pティア
動画や音声なしの場合は5.6トークン/秒（$0.112/秒）、ネイティブ音声ありで動画なしの場合は7トークン/秒（$0.14/秒）、リファレンス動画ありの場合は8.4トークン/秒（$0.168/秒）です。
4K
音声なし、ネイティブ音声あり、リファレンス動画ありの各シナリオにおいて、生成1秒あたり21トークン（$0.42/秒）です。
各リクエストの見積もり
リクエストした生成時間に、選択した解像度、リファレンス動画の使用有無、音声モードに応じた正確なレートを掛け合わせます。米ドル換算には、規定の1トークンあたり$0.02を使用します。
6ステップでKling 3.0 Omniを統合する
1
1. APIキーを作成する
GoEnhance APIキーを作成し、
Authorizationヘッダーに含めて送信してください。 2
2. モデルを選択する
modelをkling-v3-omniに設定し、@image_Nまたは@video_1素材を明示的に指定するプロンプトを作成してください。 3
3. 素材を検証する
フレームの依存関係、素材数、リファレンス動画の長さ、および
featureモードまたはbaseモードの制限事項を確認してください。 4
4. タスクを送信する
/api/v1/videos/generationsへリクエストをPOSTし、返されたimg_uuidを保持してください。 5
5. 完了状況を追跡する
GET /api/v1/jobs/detailをポーリングするか、公開アクセス可能なHTTPSのcustom_callback_urlを提供してください。 6
6. 終了状態を処理する
成功および失敗の処理を冪等（べきとう）に行います。HTTP 200を返さないコールバック受信先に対しては、1回あたり3秒のタイムアウトで最大3回まで再試行される場合があります。
明示的な入力役割と決定論的な素材リファレンスに基づいたマルチモーダル動画ワークフローを構築します。
Kling 3.0 Omniの開発者向けユースケース
リファレンス主導のキャンペーンクリップ
承認済みのキーフレームと視覚的リファレンスを、制御されたプロンプトテンプレートと組み合わせることで、キャンペーンのバリエーションを繰り返し生成できます。
製品の動きのスタディ
最初のフレームや順序付けられたリファレンス画像を使用して製品の動きを検証し、アプリケーション側でアセットの検証と承認を管理します。
動画のスタイル変換パイプライン
音声やマルチショットのルールに従い、動きやスタイルを新しい出力に反映させたい場合は、フィーチャーリファレンス動画を使用してください。
ベース動画の編集
既存の動画の音声を保持したまま、その場で編集を行いたい場合はベースモードを使用してください。
ストーリーボードのトランジション
最初と最後のフレームを入力として使用し、ジョブのオーケストレーションを変更することなく、承認済みのビジュアルビート間のトランジションを計画します。
ローカライズされたクリエイティブ自動化
プロンプトと素材リファレンスをパラメータ化して地域ごとのバリエーションを作成し、同一の非同期タスクハンドラーを再利用します。
リクエストの検証、料金、参照、非同期完了に関する実用的な回答。