画像から動画
先頭フレーム、先頭・末尾フレーム、複数キーフレームから Kling 4.0 動画を生成します。
contents にプロンプトとキーフレームを組み合わせます。画像はタスクごとに最大 10 枚です。本 API は aspect_ratio を提供しないため、目的の画角に合う参照画像を使用してください。
POST
/kling/image-to-video/kling-4.0先頭、先頭・末尾、複数キーフレームから生成します。画像はタスクごとに最大 10 枚です。画角は参照画像に従い、aspect_ratio は提供しません。
画像と参照のルール
contents は first_frame（先頭）、middle_frame（中間）、last_frame（末尾）に対応します。プロンプト項目 type: "prompt" は任意です。リクエスト例には先頭、先頭・末尾、複数キーフレームの三種類があります。
| 項目 | 要件 |
|---|---|
| 画像入力 | url 必須。URL または Base64 |
| 形式・サイズ | JPG、JPEG、PNG。各画像最大 30MB |
| 寸法 | 幅・高さとも 300px 以上、比率 2:5～5:2 |
| 画像数 | タスクごとに最大 10 枚 |
| 素材参照 ID | id は任意。指定値は同一タスク内で重複不可 |
プロンプトで画像を参照する場合は id を指定します。例えば "id": "first" は @first に対応します。id はこのリクエスト内の参照であり、生成後のタスク ID ではありません。
よくあるエラーと対処
| レスポンス・エラー | 確認と対処 |
|---|---|
HTTP 401、Invalid token | Bearer 形式と API Key の所属サイトを確認 |
HTTP 400、contents cannot be empty | 空でない contents 配列を指定 |
HTTP 400、contents must contain at least one of first_frame, middle_frame, last_frame | キーフレーム画像を一枚以上指定。プロンプトのみは不可 |
HTTP 400、must have a non-blank url | 対応するキーフレームに空でない url を指定 |
HTTP 400、contents[0].type ... is invalid | 指定インデックスの型を確認し、対応するキーフレーム・プロンプト型を使用 |
HTTP 400、invalid_request または invalid JSON request body | JSON 構文と型を確認。contents は文字列ではなく配列 |
HTTP 400 は code/message/data または error オブジェクトで返る場合があります。fail_to_fetch_task は照会エラーとは限りません。message の素材検証エラーを確認してください。この値は解析済みオブジェクトではなく JSON 文字列の場合があります。リクエスト ID を保存し、API Key は提供しないでください。