テキストから動画
Kling 4.0 のネイティブ形式でテキスト動画生成タスクを送信します。
プロンプトには生成したい内容と避けたい内容を記述できます。settings で長さ・解像度・アスペクト比、options でコールバック・透かしを設定します。
POST
/kling/text-to-video/kling-4.0プロンプトから Kling 4.0 動画を生成します。モデルはパスで指定されるため、本文に model は不要です。
よくあるエラーと対処
| レスポンス・エラー | 確認と対処 |
|---|---|
HTTP 401、Invalid token | Bearer 形式と API Key の所属サイトを確認 |
HTTP 400、prompt cannot be empty | 空でないテキストプロンプトを指定 |
HTTP 400、prompt value type is invalid | prompt は文字列。配列やオブジェクトは不可 |
HTTP 400、invalid_request | settings.duration などの型を確認。長さは整数 |
| HTTP 400、解像度・アスペクト比の検証エラー | settings.resolution と settings.aspect_ratio に本ページの列挙値を指定 |
HTTP 400、invalid JSON request body | JSON 構文を確認し、本文のコメントを削除 |
共通検証エラーにはモデルが提供する範囲より広い値が記載される場合があります。本 API は整数の 3～30 秒、720p または 1080p を使用します。エラー文だけで他の長さや解像度が使えると判断しないでください。
作成エラーは成功時と異なり、code/message/data または error オブジェクトで返る場合があります。fail_to_fetch_task の原因は message にあり、code/message/request_id を含む JSON 文字列の場合があります。リクエスト ID を保存し、API Key は提供しないでください。