model: kling-v3-motion で Kling V3 モーションコントロール にアクセスします。外見とモーションのリファレンスを提供し、非同期リクエストを1件送信して、ポーリングまたはコールバックによって返された img_uuid を追跡します。リファレンスガイド付きキャラクター動画生成のための Kling V3 モーションコントロール API
GoEnhance を通じて
APIキーを取得
外見とモーションのリファレンスを1つのリクエストに統合する
キャラクターの外見を定義する
image_url を使用して鮮明な上半身または全身のキャラクター画像を指定するか、element_ids を通じて最大1つの Kling 要素を使用します。要素を入力すると character_orientation: video が強制されます。
リファレンス動画からモーションを転送する
必須の MP4 または MOV ファイルを video_url で提供します。出力はそのファイルから使用可能な連続モーションに従います。このエンドポイントには duration パラメータはありません。
送信前にメディアを検証してください。サポートされていない長さや解像度の値は、クライアント側で拒否する必要があります。
Kling V3 モーションコントロール API の機能と検証ルール
エンドポイントとモデル
<code>model: kling-v3-motion</code> を指定して <code>https://api.goenhance.ai/api/v1/videos/generations</code> に POST リクエストを送信します。
プロンプト
キャラクター、服装、シーン、または関連する生成の方向性を説明するために、最大2,500文字の必須 <code>prompt</code> を送信します。
外見入力
<code>image_url</code> は JPG、JPEG、または PNG 形式で、最大50 MB、各辺300 px以上、アスペクト比 1:2.5 から 2.5:1 の範囲である必要があります。
モーション入力
必須の <code>video_url</code> は MP4 または MOV 形式で、最大100 MB、解像度は 340 px から 3,850 px である必要があります。
向きと長さ
<code>character_orientation: video</code> は3〜30秒、<code>image</code> は3〜10秒に対応しています。デフォルト設定は <code>video</code> です。
解像度とオーディオ
720p または 1080p を選択してください（4K層はありません）。<code>generate_audio</code> はモーション動画の元の音声を保持し、デフォルトは false です。
料金は生成された秒数に基づきますが、GoEnhanceはリクエストの上限料金として入力モーション動画の長さを測定します。
Kling V3 モーションコントロールAPIの料金
720p の料金
生成1秒あたり6.3トークン。記載されている1トークンあたり$0.02に基づくと、1秒あたり$0.126に相当します。
1080p の料金
生成1秒あたり8.4トークン。記載されている1トークンあたり$0.02に基づくと、1秒あたり$0.168に相当します。
コスト見積もり
リクエストコストの上限は、測定されたモーション動画の長さに、選択した解像度の正確な料金を乗じて見積もります。
測定された入力に対する課金
GoEnhanceはトークンを差し引く前に<code>video_url</code>を転送および測定するため、測定後にリモートファイルを変更しても、課金対象の入力には影響しません。
出力が短くなる可能性があります
Klingは使用可能な連続モーションを抽出するため、動きが困難な場合や非常に速い場合には、参照動画よりも短い出力が生成されることがあります。
durationパラメータはありません
<code>duration</code>は送信しないでください。エンドポイントで拒否され、出力の長さは参照動画から抽出された使用可能なモーションに従います。
6つのステップでKling V3 Motion Controlを統合する
1
1. APIキーを作成する
GoEnhanceのAPIキーを作成し、
Authorizationヘッダーで送信してください。 2
2. 両方の参照を検証する
画像の鮮明さと寸法を確認し、モーション動画の形式、サイズ、寸法、および向きに応じた長さを検証します。
3
3. タスクを送信して永続化する
model: kling-v3-motionを指定してリクエストをPOSTし、バックグラウンドプロセッサに作業を渡す前に、返されたimg_uuidを保存します。 4
4. ステータスを追跡する
GET /api/v1/jobs/detailをポーリングするか、公開アクセス可能なHTTPSのcustom_callback_urlを提供します。 5
5. コールバックをべき等に処理する
繰り返されるステータスイベントを安全に処理してください。HTTP 200を返さないコールバックは、試行ごとに3秒のタイムアウトで最大3回まで再試行される場合があります。
6
6. 最終結果を保存する
処理、成功、失敗のハンドリングを分離し、タスクが最終状態に達した後にのみ最終的な動画URLを保存します。
処理の許可を得ているメディアを使用し、非同期完了を前提に設計してください。
Kling V3 Motion Controlの開発者向けユースケース
キャラクターパフォーマンスクリップ
承認済みの動きの参照を、一貫したキャラクターの外観に適用し、短い物語やプロモーション動画のパイプラインを作成します。
ダンスと振り付けのプレビュー
ライセンスされたリハーサルの動きをキャラクター主導のプレビューに転送し、同意およびソース音声の権利を保護します。
ゲームキャラクターのアニメーションコンセプト
本格的なアニメーションワークフローに着手する前に、キャラクターアートと記録された動きからモーションスタディを生成します。
ローカライズされたキャンペーンバリエーション
1つのジョブオーケストレーションレイヤーを再利用しながら、地域ごとのクリエイティブバリエーションに合わせてプロンプトと外観の入力をパラメータ化します。
バーチャルパフォーマーのワークフロー
承認済みの画像参照、モーションアセット、向きの設定に基づいて、制御されたパフォーマーパイプラインを構築します。
プリビジュアライゼーション
ダウンストリームでの編集、合成、レビューの前に、モーション参照がキャラクターに適しているかどうかをテストします。
統合、料金、検証、およびKuaishou APIに関する一般的な質問への回答です。