Kling 動画 API 仕様

kling-3.0-turbo の解像度別課金（720P / 1080P / 2K / 4K）による呼び出し方法と、長さ、アスペクト比、参照画像と参照動画、開始・終了フレーム、音声のルール。

このページは、Kuaishou（快手）の Kling 動画モデル kling-3.0-turbo の呼び出し仕様です。このモデルは、他の動画モデルと同じく POST /v1/videos で作成し、GET /v1/videos/{id} でポーリングします。認証、素材のアップロード、ポーリングのステータス、結果のダウンロード、エラー処理は動画 API 完全呼び出し仕様を参照してください。このページでは、Kling に固有のフィールドとルールだけを説明します。

2026-10-10 更新。Kling のモデルはポーリングのみに対応しています。作成時に callback_url を設定するとリクエストは拒否されます。

モデル一覧

モデル	選択可能な解像度	長さ	アスペクト比	画像／動画／音声の上限
`kling-3.0-turbo`	`720p`（デフォルト）、`1080p`、`2k`、`4k`	4–15 秒、デフォルト 5 秒	`16:9` `9:16` `1:1`、デフォルト `16:9`	30（開始・終了フレームを含む）/ 10 / 0

resolution で出力解像度を選択し、その解像度で課金されます。大文字・小文字は区別されません（4k と 4K は同じ扱いです）。省略すると最も低い 720p になります。対応していない解像度を指定すると 400 が返され、自動的に解像度を下げることはありません。

共通ルール

長さ：duration（または文字列形式の seconds）に 4–15 の整数の秒数を指定します。省略すると 5 秒です。
アスペクト比：ratio（または aspect_ratio）に 16:9、9:16、1:1 を指定できます。
プロンプト：prompt は必須で、最大 2000 文字です。
音声生成：generate_audio（ブール値）に対応しています。
参照音声：非対応です。参照音声を送ると 400 が返されます。
任意フィールド：negative_prompt（ネガティブプロンプト）、seed（整数）。

参照画像と参照動画

参照画像はトップレベルの images、参照動画は metadata.referenceVideos に指定します。画像は最大 30 枚（開始・終了フレームを含む）、動画は最大 10 本です。

{
  "model": "kling-3.0-turbo",
  "resolution": "1080p",
  "prompt": "参照画像の製品の外観を保ち、参照動画のカメラのテンポで、テーブルの上でゆっくり回転する製品を見せる",
  "duration": 10,
  "ratio": "16:9",
  "generate_audio": true,
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-side.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"]
  }
}

開始・終了フレーム

開始フレームと終了フレームは metadata.firstFrame と metadata.lastFrame に指定します。lastFrame は必ず firstFrame と一緒に指定します。Kling では開始・終了フレームと参照画像を一緒に送ることができ、合計で 30 枚までです。

{
  "model": "kling-3.0-turbo",
  "resolution": "4k",
  "prompt": "早朝の海岸から夕暮れの同じ入り江へ、カメラがなめらかに進む",
  "duration": 5,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

ファイルのアップロード

multipart/form-data でローカルの画像ファイル 1 つを直接アップロードすることもできます。フィールド名は input_reference で、この場合は images や image を同時に送れません。参照動画はファイルとして送れないため、先にローカル素材のアップロードの手順で URL を取得してください。

旧モデル名

以前の解像度接尾辞付きのモデル名 kling-3.0-turbo-720p、kling-3.0-turbo-1080p、kling-3.0-turbo-2k、kling-3.0-turbo-4k は 2026-10-10 に提供を終了しました。これらの名前で送信するとエラーが返されます。kling-3.0-turbo を使用し、resolution で解像度を選択してください。