Kling 動画 API:テキスト・画像からの生成とモーション制御
BetterToken API Key で Kling に接続し、Model ID と操作に応じたフィールド、素材、生成方法を選びます。
テキストや画像から動画を生成し、人物の参照画像 1 枚と動作動画を組み合わせて動きを制御できます。kling-v3 の出力設定には provider_options.kling.mode を使います。Omni、Turbo、Motion Control はそれぞれの解像度フィールドを使います。
まず BetterToken API Key を用意してください。Base URL は https://bettertoken.ai/v1、認証は Authorization: Bearer YOUR_API_KEY です。Model ID は大文字・小文字も含めて、そのままコピーしてください。
以下の各 request.json は同じ手順で使います。まず見積もりを取得し、確認後に作成、ポーリング、ダウンロードを行います。見積もりでは生成を開始しません。作成すると有料タスクを送信します。現在の料金はモデル広場で確認してください。
モデルと操作
以下の表は操作別の選択肢です。フィールドのデフォルト値、素材数、組み合わせの制約は各節を参照してください。素材サイズは 1 MB = 1048576 バイトで換算しています。
| Model ID | 操作 | 長さ(秒) | 出力設定 | アスペクト比 | 音声 | 素材の役割 |
|---|---|---|---|---|---|---|
kling-3.0-turbo | text_to_video | 5–10、5 刻み | 720p、1080p | 16:9、9:16、1:1 | on | なし |
kling-v3-motion-control | reference_to_video | 3–10 秒の参照動画に追従 | 720p、1080p | 指定しない | off、on | reference_image、reference_video |
kling-v3-omni | text_to_video | 3–15、1 刻み | 720p、1080p、4k | 16:9、9:16、1:1 | off、on | なし |
kling-v3 | image_to_video | 3–15、1 刻み | std、pro、4k | 指定しない | off、on | first_frame、last_frame |
kling-v3 | text_to_video | 3–15、1 刻み | std、pro、4k | 16:9、9:16、1:1 | off、on | なし |
kling-v3 は output.resolution を受け付けず、画像からの動画生成では output.aspect_ratio も受け付けません。kling-v3-motion-control は provider_options を受け付けません。Turbo の長さは 5 秒か 10 秒のみで、音声は on 固定です。
サンプル素材
画像からの動画生成と画像参照の例には、白いテーブルの上にある青い陶器のマグカップを使います。そのまま試すか、自分に使用権があり、このページの制限を満たす公開 HTTPS 素材に置き換えてください。

モーション制御の例には少年の参照画像と同じ少年の動作動画を使い、プロンプトもこの人物素材に合わせています。動画は約 5.04 秒、1280 × 720、24 fps です。
テキストから動画を生成する
kling-3.0-turbo
テキストの説明だけで動画を生成したい場合に使います。
model にこの節の Model ID、operation に text_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | on | on |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 5–10、5 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | 16:9、9:16、1:1 | 16:9 |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 720p、1080p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false | false |
素材の要件
この操作は素材を受け付けません。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "kling-3.0-turbo", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
kling-v3-omni
テキストの説明だけで動画を生成したい場合に使います。
model にこの節の Model ID、operation に text_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | off、on | off |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 3–15、1 秒刻み。固定長の場合のみ | 3 |
output.aspect_ratio | string | いいえ | 16:9、9:16、1:1 | 16:9 |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 720p、1080p、4k | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false | false |
素材の要件
この操作は素材を受け付けません。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。output.resolution="4k"を選ぶ場合はaudio.mode="off"が必須です。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "kling-v3-omni", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
kling-v3
テキストの説明だけで動画を生成したい場合に使います。
model にこの節の Model ID、operation に text_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | off、on | off |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 3–15、1 秒刻み。固定長の場合のみ | 5 |
output.aspect_ratio | string | いいえ | 16:9、9:16、1:1 | 16:9 |
output.format | string | いいえ | mp4 | mp4 |
prompt | string | いいえ | 文字列 | なし |
provider_options.kling.camera_axis | string | いいえ | horizontal、vertical、pan、tilt、roll、zoom | なし |
provider_options.kling.camera_type | string | いいえ | simple、down_back、forward_up、right_turn_forward、left_turn_forward | なし |
provider_options.kling.camera_value | integer | いいえ | -10–10、1 刻み。0 は不可 | なし |
provider_options.kling.mode | string | いいえ | std、pro、4k | std |
provider_options.kling.negative_prompt | string | いいえ | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
この操作は素材を受け付けません。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "kling-v3", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "aspect_ratio": "16:9" }, "provider_options": { "kling": { "mode": "std" } }}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
画像から動画を生成する
kling-v3
画像で開始画面、または開始・終了画面を指定したい場合に使います。
model にこの節の Model ID、operation に image_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | off、on | off |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 3–15、1 秒刻み。固定長の場合のみ | 5 |
output.format | string | いいえ | mp4 | mp4 |
prompt | string | いいえ | 文字列 | なし |
provider_options.kling.camera_axis | string | いいえ | horizontal、vertical、pan、tilt、roll、zoom | なし |
provider_options.kling.camera_type | string | いいえ | simple、down_back、forward_up、right_turn_forward、left_turn_forward | なし |
provider_options.kling.camera_value | integer | いいえ | -10–10、1 刻み。0 は不可 | なし |
provider_options.kling.mode | string | いいえ | std、pro、4k | std |
provider_options.kling.negative_prompt | string | いいえ | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
first_frame | image、任意、最大 1 個 | jpg、jpeg、png | サイズ上限 10 MB。幅 300–100000 px。高さ 300–100000 px |
last_frame | image、任意、最大 1 個 | jpg、jpeg、png | サイズ上限 10 MB。幅 300–100000 px。高さ 300–100000 px |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。first_frame、last_frameのうち少なくとも 1 つを指定してください。- 末尾フレーム
last_frameを送る場合はprovider_options.kling.camera_typeを設定しないでください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "kling-v3", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "provider_options": { "kling": { "mode": "std" } }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
参照素材から生成する
kling-v3-motion-control
参照素材で被写体や動作の特徴を保ちたい場合に使います。
model にこの節の Model ID、operation に reference_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | off、on | off |
duration.mode | string | いいえ | auto | auto |
duration.seconds | integer | いいえ | 指定しない。3–10 秒の参照動画に追従 | なし |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 720p、1080p | 720p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
reference_image | image、1 個(必須) | jpg、jpeg、png | サイズ上限 10 MB。幅 300–16384 px。高さ 300–16384 px |
reference_video | video、1 個(必須) | mp4、mov | サイズ上限 100 MB。長さ 3–10 秒。この役割の合計上限 10 秒 |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
- 自動の長さを使い、出力時間は参照動画に従います。
duration.secondsは指定しないでください。
reference_image 1 枚と reference_video 1 本が必須で、それぞれ 1 つだけ指定してください。アスペクト比や追加の provider_options は設定しないでください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "kling-v3-motion-control", "operation": "reference_to_video", "prompt": "Animate the boy in the reference image following the motion in the reference video. Preserve his appearance.", "duration": { "mode": "auto" }, "output": { "resolution": "720p" }, "media": [ { "id": "person", "type": "image", "role": "reference_image", "source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0-poster.jpg" }, { "id": "motion", "type": "video", "role": "reference_video", "source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0.mp4" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
excludes | 自動の長さや末尾フレームと競合するフィールドを削除する。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
公式資料
BetterToken を呼び出す際は、このページのフィールドとリアルタイムのモデルカタログで該当する操作を確認してください。

