メインコンテンツへスキップ
本文では、Kling Motion Generation API の接続説明を紹介します。これは、カスタムパラメータを入力することでKling公式の動画を生成することができます。

​
申請プロセス

APIを使用するには、まず Kling Motion Generation API の該当ページでサービスを申請する必要があります。ページに入ったら、「Acquire」ボタンをクリックします。以下の図のように： まだログインまたは登録していない場合、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。 初回申請時には無料のクレジットが付与され、この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」ボタンをクリックするとテストができます。上の図のように、以下の結果を得ました： 
{
  "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のコードは以下の通りです： 
curl -X POST 'https://api.acedata.cloud/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.acedata.cloud/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/ を使用します。このサイトを開くとWebhook URLが得られます。以下の図のように： この 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 で生成された動画の結果を確認できます。以下の図の通りです： 内容は以下の通りです： 
{
    "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：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

​
エラー応答の例

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
結論

この文書を通じて、Kling Motion Generation API を使用して Kling の公式の動作制御機能を実現する方法を理解しました。この文書が API の接続と使用に役立つことを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。