リファレンスガイド付きキャラクター動画生成のための Kling V3 モーションコントロール API

GoEnhance を通じて model: kling-v3-motion で Kling V3 モーションコントロール にアクセスします。外見とモーションのリファレンスを提供し、非同期リクエストを1件送信して、ポーリングまたはコールバックによって返された img_uuid を追跡します。
APIキーを取得
Kling V3 モーションコントロール API による映画のようなモーションリファレンス制作

外見とモーションのリファレンスを1つのリクエストに統合する

キャラクターの外見を定義する

image_url を使用して鮮明な上半身または全身のキャラクター画像を指定するか、element_ids を通じて最大1つの Kling 要素を使用します。要素を入力すると character_orientation: video が強制されます。
キャラクター動画生成のための制御された外見リファレンス写真

リファレンス動画からモーションを転送する

必須の MP4 または MOV ファイルを video_url で提供します。出力はそのファイルから使用可能な連続モーションに従います。このエンドポイントには duration パラメータはありません。
モーションリファレンスとして使用される単一シーンの振り付けリハーサル
送信前にメディアを検証してください。サポートされていない長さや解像度の値は、クライアント側で拒否する必要があります。

Kling V3 モーションコントロール API の機能と検証ルール

エンドポイントとモデル

model: kling-v3-motion を指定して https://api.goenhance.ai/api/v1/videos/generations に POST リクエストを送信します。

プロンプト

キャラクター、服装、シーン、または関連する生成の方向性を説明するために、最大2,500文字の必須 prompt を送信します。

外見入力

image_url は JPG、JPEG、または PNG 形式で、最大50 MB、各辺300 px以上、アスペクト比 1:2.5 から 2.5:1 の範囲である必要があります。

モーション入力

必須の video_url は MP4 または MOV 形式で、最大100 MB、解像度は 340 px から 3,850 px である必要があります。

向きと長さ

character_orientation: video は3〜30秒、image は3〜10秒に対応しています。デフォルト設定は video です。

解像度とオーディオ

720p または 1080p を選択してください(4K層はありません)。generate_audio はモーション動画の元の音声を保持し、デフォルトは 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はトークンを差し引く前にvideo_urlを転送および測定するため、測定後にリモートファイルを変更しても、課金対象の入力には影響しません。

出力が短くなる可能性があります

Klingは使用可能な連続モーションを抽出するため、動きが困難な場合や非常に速い場合には、参照動画よりも短い出力が生成されることがあります。

durationパラメータはありません

durationは送信しないでください。エンドポイントで拒否され、出力の長さは参照動画から抽出された使用可能なモーションに従います。

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を保存します。
APIキーを取得
処理の許可を得ているメディアを使用し、非同期完了を前提に設計してください。

Kling V3 Motion Controlの開発者向けユースケース

キャラクターパフォーマンスクリップ

承認済みの動きの参照を、一貫したキャラクターの外観に適用し、短い物語やプロモーション動画のパイプラインを作成します。

ダンスと振り付けのプレビュー

ライセンスされたリハーサルの動きをキャラクター主導のプレビューに転送し、同意およびソース音声の権利を保護します。

ゲームキャラクターのアニメーションコンセプト

本格的なアニメーションワークフローに着手する前に、キャラクターアートと記録された動きからモーションスタディを生成します。

ローカライズされたキャンペーンバリエーション

1つのジョブオーケストレーションレイヤーを再利用しながら、地域ごとのクリエイティブバリエーションに合わせてプロンプトと外観の入力をパラメータ化します。

バーチャルパフォーマーのワークフロー

承認済みの画像参照、モーションアセット、向きの設定に基づいて、制御されたパフォーマーパイプラインを構築します。

プリビジュアライゼーション

ダウンストリームでの編集、合成、レビューの前に、モーション参照がキャラクターに適しているかどうかをテストします。
統合、料金、検証、およびKuaishou APIに関する一般的な質問への回答です。

Kling V3 モーション制御API FAQ

Kling V3 モーションコントロールAPIのエンドポイントとは何ですか?

GoEnhanceを通じてPOST https://api.goenhance.ai/api/v1/videos/generationsにmodel: kling-v3-motionを指定して送信してください。レスポンスとしてimg_uuidが返されます。

Kling V3 モーションコントロールAPIの料金体系はどのようになっていますか?

720pは6.3トークン/秒($0.126/秒)、1080pは8.4トークン/秒($0.168/秒)です。GoEnhanceは、リクエストの課金上限として、控除前に動画のモーション時間を測定します。

duration(期間)パラメータを送信できますか?

いいえ。このエンドポイントはdurationを受け付けません。参照動画は向きに応じた制限を満たす必要があり、出力はそこから抽出された使用可能な連続モーションに従います。

character_orientation(キャラクターの向き)を変更するとどうなりますか?

videoはモーション動画内の向きに従い、3〜30秒まで可能です。imageは外観画像に従い、3〜10秒まで可能です。

APIでネイティブ音声を生成できますか?

いいえ。generate_audioはモーション動画の元のサウンドトラックを保持するだけです。デフォルトはfalseです。必要な権利を保持している場合にのみ音声を使用してください。

画像の代わりにKling要素を使用できますか?

V3ルートでは、element_ids(または単一値のエイリアスelement_id)を通じて最大1つの値を受け付けます。要素を入力すると、character_orientation: videoが強制されます。

コールバックはどのように機能しますか?

公開されているHTTPSのcustom_callback_urlを指定してください。コールバックの本文はジョブ詳細のレスポンスと一致します。200以外のレスポンスが返された場合、3秒のタイムアウトで最大3回まで再試行されることがあります。

これはKuaishouの公式APIですか?

いいえ。KlingはKuaishouに関連していますが、このページではGoEnhanceを通じた独立したアクセスについて説明しています。GoEnhanceは、KuaishouやKlingの公式API、パートナー、またはモデル開発者として提供されているものではありません。

Kling V3 モーション制御APIで構築する