Skip to main content

作成するもの

Kling のテキストから動画へのタスクを送信し、返されたタスク ID を保存し、対応する Kling タスクエンドポイントをポーリングして、プッシュ通知のためにいつ callback_url を追加するかを判断します。

前提条件

  • COMETAPI_KEY に保存された CometAPI API キー
  • requests を使用する Python 3.10+、または Node.js 18+
  • ポーリング用のサーバーサイドワーカー、または webhook 用の HTTPS コールバックエンドポイント

API キー、ベース URL、認証

次の方法で Kling のテキストから動画へのタスクを作成します:
次の方法でタスクをポーリングします:
Bearer トークンで認証します:

コード例

以下のタブから、cURL、Python、Node.js のコピー可能な例を利用できます。

フローの説明

Kling の動画生成は非同期です。create エンドポイントは data.task_id を返します。data.task_statussucceed または failed になるまで GET /kling/v1/videos/text2video/<task_id> をポーリングしてください。タスクが成功したら、永続的にアクセスする必要がある場合は、完成したアセット URL を data.task_result から自分のストレージにコピーします。 タスクのステータス更新を自分で管理する HTTPS エンドポイントにプッシュしたい場合は、callback_url を追加します。照合や callback 配信漏れに備えて、ポーリングも引き続き利用できるようにしておいてください。

一般的なパラメータ

トラブルシューティング / FAQ

Kling は data.task_iddata.task_statusdata.task_result など、プロバイダー固有の JSON フィールドを使用します。OpenAI 互換の /v1/videos ルートのようにパースしないでください。
上限を設けたポーリングを行い、タスクが失敗した場合は data.task_status_msg を確認してください。後で診断できるよう、task ID を保存しておいてください。
基本はポーリングを使用してください。プッシュ配信が必要な場合は callback_url を追加し、その後ポーリングで最終状態を照合します。

次のステップ