作成するもの
Kling のテキストから動画へのタスクを送信し、返されたタスク ID を保存し、対応する Kling タスクエンドポイントをポーリングして、プッシュ通知のためにいつcallback_url を追加するかを判断します。
前提条件
COMETAPI_KEYに保存された CometAPI API キーrequestsを使用する Python 3.10+、または Node.js 18+- ポーリング用のサーバーサイドワーカー、または webhook 用の HTTPS コールバックエンドポイント
API キー、ベース URL、認証
次の方法で Kling のテキストから動画へのタスクを作成します:コード例
以下のタブから、cURL、Python、Node.js のコピー可能な例を利用できます。フローの説明
Kling の動画生成は非同期です。create エンドポイントはdata.task_id を返します。data.task_status が succeed または failed になるまで GET /kling/v1/videos/text2video/<task_id> をポーリングしてください。タスクが成功したら、永続的にアクセスする必要がある場合は、完成したアセット URL を data.task_result から自分のストレージにコピーします。
タスクのステータス更新を自分で管理する HTTPS エンドポイントにプッシュしたい場合は、callback_url を追加します。照合や callback 配信漏れに備えて、ポーリングも引き続き利用できるようにしておいてください。
一般的なパラメータ
トラブルシューティング / FAQ
レスポンスの形式が OpenAI の video ルートと異なります
レスポンスの形式が OpenAI の video ルートと異なります
Kling は
data.task_id、data.task_status、data.task_result など、プロバイダー固有の JSON フィールドを使用します。OpenAI 互換の /v1/videos ルートのようにパースしないでください。タスクが succeed に到達しません
タスクが succeed に到達しません
上限を設けたポーリングを行い、タスクが失敗した場合は
data.task_status_msg を確認してください。後で診断できるよう、task ID を保存しておいてください。callback_url とポーリングのどちらを使うべきですか
callback_url とポーリングのどちらを使うべきですか
基本はポーリングを使用してください。プッシュ配信が必要な場合は
callback_url を追加し、その後ポーリングで最終状態を照合します。次のステップ
- Kling text-to-video API リファレンス を参照してください。
- Get a Kling task でポーリングします。
- Use Kling callback URLs で callback を設定します。
- Models で Kling の video model を確認します。
- Use polling and webhooks for video generation を確認してください。
- Estimate request cost before calling a model でタスクコストを見積もってください。