申請プロセス
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。
success：この時点での動画生成タスクの状態。task_id：この時点での動画生成タスクID。video_id：この時点での動画生成タスクの動画ID。video_url：この時点での動画生成タスクの動画リンク。duration：この時点での動画生成タスクの動画の長さ。state：この時点での動画生成タスクの状態。
data の動画リンクアドレスに基づいて生成されたKling動画を取得するだけです。
また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURLのコードは以下の通りです：
非同期コールバック
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 に設定し、対応するパラメータを入力します。具体的な内容は以下の図の通りです：
https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3 で生成された動画の結果を確認できます。以下の図の通りです：
内容は以下の通りです：
task_id フィールドが含まれており、他のフィールドは上記と似ています。このフィールドを通じてタスクの関連付けが可能です。
エラーハンドリング
API を呼び出す際にエラーが発生した場合、API は対応するエラーコードと情報を返します。例えば：400 token_mismatched：不正なリクエスト、パラメータが欠落または無効な可能性があります。400 api_not_implemented：不正なリクエスト、パラメータが欠落または無効な可能性があります。401 invalid_token：未認証、無効または欠落した認証トークン。429 too_many_requests：リクエストが多すぎます、レート制限を超えました。500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。