申請プロセス
Kling Motion Generation APIを使用するには、まず Ace Data Cloud コンソール でAPIトークンを取得し、保管してください。
まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。
1つのAPIトークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソールで一般残高をチャージできます。
📘 完全なドキュメント：Kling Motion Generation API →
基本的な使用法
まず、基本的な使用方法を理解します。これは、プロンプトprompt、参照画像 image_url、および参照動画リンク video_url を入力することで処理された結果を得ることができます。その後、モデル mode を入力する必要があります。現在、主に std と pro の2つのモデルがあります。具体的な内容は以下の通りです：
accept：受け取りたいレスポンス結果の形式。ここではapplication/json、つまりJSON形式を記入します。authorization：APIを呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
image_url：人物の外観参考画像のURL。JPG/JPEG/PNGをサポートし、ファイルサイズは≤50MB、幅と高さはそれぞれ≥300px、アスペクト比は1:2.5～2.5:1；人物は上半身または全身および頭部が明確に表示される必要があります。video_url：動作参考動画のURL。MP4/MOVをサポートし、ファイルサイズは≤100MB、幅と高さは340–3850px、少なくとも3秒；character_orientation=imageの場合は最大10秒、character_orientation=videoの場合は最大30秒。人物が常に画面内にいる連続した単一ショットの動画を使用することをお勧めします。mode：生成する動画のモード。主に標準モードstdと高速モードproの2種類があります。keep_original_sound：動画の原音を保持するかどうかを選択できます。列挙値：yes、no。character_orientation：生成動画中の人物の向き。画像と一致させるか動画と一致させるかを選択できます。列挙値：image、video。prompt：プロンプト。callback_url：結果をコールバックするURL。async：オプション。trueに設定すると、インターフェースはすぐにtask_idを返し、callback_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：内部サーバーエラー、サーバーで何かがうまくいきませんでした。