> ## Documentation Index > Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # Kling Motion Generation API 接続説明 > Kling video generation 集成指南 - XHuoAPI 本文では、Kling Motion Generation API の接続説明を紹介します。これは、カスタムパラメータを入力することでKling公式の動画を生成することができます。 ## 申請プロセス APIを使用するには、まず [Kling Motion Generation API](https://api.xhuoapi.ai/documents/d3f2c369-102d-4856-9565-702ac5f2df63) の該当ページでサービスを申請する必要があります。ページに入ったら、「Acquire」ボタンをクリックします。以下の図のように： ![](https://cdn.xhuoapi.ai/q6ytrc.png) まだログインまたは登録していない場合、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。 初回申請時には無料のクレジットが付与され、このAPIを無料で使用できます。 ## 基本使用 まず、基本的な使用方法を理解します。これは、プロンプト `prompt`、参考画像 `image_url`、および参考動画リンク `video_url` を入力することで処理された結果を得ることができます。その後、モデル `mode` を入力する必要があります。現在、主に `std` と `pro` の2つのモデルがあります。具体的な内容は以下の通りです：

ここでは、リクエストヘッダーを設定しています。これには以下が含まれます： * `accept`：受け取りたいレスポンス結果の形式。ここでは `application/json`、つまりJSON形式を記入します。 * `authorization`：APIを呼び出すためのキー。申請後、直接ドロップダウンから選択できます。 また、リクエストボディを設定しています。これには以下が含まれます： * `image_url`：参考画像。生成される動画の人物、背景などの要素はすべてこの画像を基準にします。 * `video_url`：参考動画の取得リンク。生成される動画の人物の動きは参考動画と一致します。 * `mode`：生成される動画のモード。主に標準モード `std` と高速モード `pro` の2種類があります。 * `keep_original_sound`：動画の原音を保持するかどうかを選択できます。列挙値：yes、no。 * `character_orientation`：生成される動画の人物の向きを選択できます。画像と一致させるか、動画と一致させるか。列挙値：image、video。 * `prompt`：プロンプト。 * `callback_url`：結果をコールバックするURL。 選択後、右側にも対応するコードが生成されていることがわかります。以下の図のように：

「Try」ボタンをクリックするとテストができます。上の図のように、以下の結果を得ました： ```json theme={null} { "success": true, "video_id": "842578800134742051", "video_url": "https://v4-fdl.kechuangai.com/ksc2/yGPGHvUVDQEzDCs6tC0rYIbd_JwWNFaF8BEYAlw_xVcWX72xFuIUVqB_Hp5Sa7YEijI-yXqfKI92WW7bmyeCtpMjSOImlOFpQCmMUa-9iojt_ifXJnex_tvNkA0ZlJmuJLpeOfvX3j8d9oeeWgLeU3ftzBjQq1g9OC9FU92OfjRQLUTSzfWRzkhzirV32BT-BwfxgqJKsUD-WHxjqCJmOw.mp4?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAHtyCrKxB23NXn5ddMedV5Mw4pp_kOk_TRbCVA-wO9LJZuga8_KxXCzhw6bU3hS1V5PpNoSTxSkm_E80i5U1PkJ5d444cjPvoIq2VboPqCip2QbsoiVMu6CuGP7tB7fStLbezBNA4lQtHeSVPxWTE7Hy0wbJ33tKlf-X_-1ad3u0cyHfT_8EroD4iYZ1ZVasuYxAKjcdmbbVZ7NlDK9rqyI5euyz-70-M-QM5Lk6l88SRoSS2Y9drB8Z4ednHxTIh7XZcnaIiB5Xf4Mv8Rc51nUyIC5lKp02LP7oViCg6OaAhR4ynNJkCgFMAE&x-kcdn-pid=112757&pkey=AAX8ukavvkZsIz-IUg2pTvMOAV7LVItIdg_5TUYhGA1YINT8x-SR7rXY7BWLKqspLTYIjK7C0SjbXtX25Lm4_sx2V229AIyfVzjrlQQ7IjPsxvAv9cTG72YN0TPSjVowBZQ", "duration": "5.066", "state": "succeed", "task_id": "363c7a84-e880-472e-a4d4-098e50cfc292" } ``` 返された結果には複数のフィールドがあり、以下のように説明されます： * `success`：この時点での動画生成タスクの状態。 * `task_id`：この時点での動画生成タスクID。 * `video_id`：この時点での動画生成タスクの動画ID。 * `video_url`：この時点での動画生成タスクの動画リンク。 * `duration`：この時点での動画生成タスクの動画の長さ。 * `state`：この時点での動画生成タスクの状態。 満足のいく動画情報を得ることができました。結果の `data` の動画リンクアドレスに基づいて生成されたKling動画を取得するだけです。 また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURLのコードは以下の通りです： ```shell theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/kling/motion' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "image_url": "https://sourceyoya.wenge.com/2025/06/03/683e9f76e4b0684509ab1aca.jpg", "video_url": "https://cdn.xhuoapi.ai/odwfm5.mp4", "prompt": "画面を生き生きとさせる", "mode": "std", "character_orientation": "image" }' ``` ## 非同期コールバック Kling Motion Generation APIの生成時間は比較的長く、約1〜2分かかります。APIが長時間応答しない場合、HTTPリクエストは接続を維持し続け、追加のシステムリソースを消費するため、本APIは非同期コールバックのサポートも提供しています。 全体の流れは、クライアントがリクエストを発行する際に、追加で `callback_url` フィールドを指定します。クライアントがAPIリクエストを発行すると、APIはすぐに結果を返し、現在のタスクIDを示す `task_id` フィールド情報を含みます。タスクが完了すると、生成された動画の結果がPOST JSON形式でクライアントが指定した `callback_url` に送信され、その中にも `task_id` フィールドが含まれます。これにより、タスク結果をIDで関連付けることができます。 以下の例を通じて、具体的にどのように操作するかを理解しましょう。 まず、WebhookコールバックはHTTPリクエストを受け取ることができるサービスであり、開発者は自分が構築したHTTPサーバーのURLに置き換える必要があります。ここでは、デモのために公開されたWebhookサンプルサイト [https://webhook.site/](https://webhook.site/) を使用します。このサイトを開くとWebhook URLが得られます。以下の図のように： ![](https://cdn.xhuoapi.ai/tbcnai.png) この URL をコピーすれば、Webhook として使用できます。ここでのサンプルは `https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3` です。 次に、フィールド `callback_url` を上記の Webhook URL に設定し、対応するパラメータを入力します。具体的な内容は以下の図の通りです：

実行をクリックすると、すぐに結果が得られます。以下の通りです： ``` { "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0" } ``` 少し待つと、`https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3` で生成された動画の結果を確認できます。以下の図の通りです： ![](https://cdn.xhuoapi.ai/zv5u2q.png) 内容は以下の通りです： ```json theme={null} { "success": true, "video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c", "video_url": "https://cdn.klingai.com/bs2/upload-kling-api/7822108635/text2video/CjJzzGfBfqcAAAAAAKdVMQ-0_raw_video_1.mp4", "duration": "5.1", "state": "succeed", "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0" } ``` 結果には `task_id` フィールドが含まれており、他のフィールドは上記と似ています。このフィールドを通じてタスクの関連付けが可能です。 ## エラーハンドリング API を呼び出す際にエラーが発生した場合、API は対応するエラーコードと情報を返します。例えば： * `400 token_mismatched`：不正なリクエスト、パラメータが欠落または無効な可能性があります。 * `400 api_not_implemented`：不正なリクエスト、パラメータが欠落または無効な可能性があります。 * `401 invalid_token`：未認証、無効または欠落した認証トークン。 * `429 too_many_requests`：リクエストが多すぎます、レート制限を超えました。 * `500 api_error`：内部サーバーエラー、サーバーで何かがうまくいきませんでした。 ### エラー応答の例 ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## 結論 この文書を通じて、Kling Motion Generation API を使用して Kling の公式の動作制御機能を実現する方法を理解しました。この文書が API の接続と使用に役立つことを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。