Skip to main content
POST
cURL
ソース画像が 1 枚では不十分で、複数の画像参照から Kling に動きを構築させたい場合は、このエンドポイントを使用します。

呼び出し前に

  • image_list に 1 ~ 4 枚の画像を用意します
  • Kling のピクセル要件を満たす画像を使用してください。小さすぎるサムネイルは生成タスクで拒否されます
  • ルート互換モデルを明示的に選択する必要がある場合を除き、model_name は省略してください
  • 最初のテストはシンプルにしてください。短い prompt、duration: 5、追加のコールバック設定なしで始めます
  • このルートでは、static_maskdynamic_masks などの image-to-video マスクフィールドを送信しないでください

タスクの流れ

1

マルチ画像リクエストを送信する

画像リスト、prompt、duration を送信し、返された Kling の task_id を保存します。
2

タスクをポーリングする

タスクが終端状態に達するまで、Kling タスクを取得する を使って確認を続けます。
3

結果を保存する

プロバイダーの配信 URL を超えて保持する必要がある場合は、完成した動画を保存します。
完全なパラメータリファレンスについては、Kling 公式ドキュメント を参照してください。

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

ボディ

application/json
image_list
object[]
必須

Input image references. Provide 1 to 4 items that meet Kling pixel requirements; very small thumbnails are rejected.

Required array length: 1 - 4 elements
model_name
enum<string>
デフォルト:kling-v1-6

Kling model variant for multi-image video. Omit to use kling-v1-6.

利用可能なオプション:
kling-v1-6
prompt
string

Text prompt describing the desired motion and scene.

negative_prompt
string

Elements to avoid in the generated video.

mode
enum<string>
デフォルト:std

Generation mode. Use std or pro; omitted requests use std.

利用可能なオプション:
std,
pro
duration
string
デフォルト:5

Output video length in seconds. Use 5 or 10; omitted requests use 5.

aspect_ratio
enum<string>

Requested frame aspect ratio when the model needs an explicit frame shape.

利用可能なオプション:
16:9,
9:16,
1:1
callback_url
string

Webhook URL to receive task status updates.

external_task_id
string

Custom task id for your own tracking. Must be unique per account.

レスポンス

200 - application/json

Task accepted.

code
integer
必須

Error code; specifically define the error code

message
string
必須

error message

data
object
必須