コンテンツにスキップ
無料で登録
Kling

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-turbotext_to_video5–10、5 刻み720p、1080p16:9、9:16、1:1onなし
kling-v3-motion-controlreference_to_video3–10 秒の参照動画に追従720p、1080p指定しないoff、onreference_image、reference_video
kling-v3-omnitext_to_video3–15、1 刻み720p、1080p、4k16:9、9:16、1:1off、onなし
kling-v3image_to_video3–15、1 刻みstd、pro、4k指定しないoff、onfirst_frame、last_frame
kling-v3text_to_video3–15、1 刻みstd、pro、4k16:9、9:16、1:1off、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.modestringいいえonon
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ5–10、5 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえ16:9、9:16、1:116:9
output.formatstringいいえmp4mp4
output.resolutionstringいいえ720p、1080p720p
promptstringはい文字列なし
watermarkbooleanいいえfalsefalse

素材の要件

この操作は素材を受け付けません。

組み合わせの制約

  • 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.modestringいいえoff、onoff
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ3–15、1 秒刻み。固定長の場合のみ3
output.aspect_ratiostringいいえ16:9、9:16、1:116:9
output.formatstringいいえmp4mp4
output.resolutionstringいいえ720p、1080p、4k720p
promptstringはい文字列なし
watermarkbooleanいいえfalsefalse

素材の要件

この操作は素材を受け付けません。

組み合わせの制約

  • 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.modestringいいえoff、onoff
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ3–15、1 秒刻み。固定長の場合のみ5
output.aspect_ratiostringいいえ16:9、9:16、1:116:9
output.formatstringいいえmp4mp4
promptstringいいえ文字列なし
provider_options.kling.camera_axisstringいいえhorizontal、vertical、pan、tilt、roll、zoomなし
provider_options.kling.camera_typestringいいえsimple、down_back、forward_up、right_turn_forward、left_turn_forwardなし
provider_options.kling.camera_valueintegerいいえ-10–10、1 刻み。0 は不可なし
provider_options.kling.modestringいいえstd、pro、4kstd
provider_options.kling.negative_promptstringいいえ文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

この操作は素材を受け付けません。

組み合わせの制約

  • 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.modestringいいえoff、onoff
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ3–15、1 秒刻み。固定長の場合のみ5
output.formatstringいいえmp4mp4
promptstringいいえ文字列なし
provider_options.kling.camera_axisstringいいえhorizontal、vertical、pan、tilt、roll、zoomなし
provider_options.kling.camera_typestringいいえsimple、down_back、forward_up、right_turn_forward、left_turn_forwardなし
provider_options.kling.camera_valueintegerいいえ-10–10、1 刻み。0 は不可なし
provider_options.kling.modestringいいえstd、pro、4kstd
provider_options.kling.negative_promptstringいいえ文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
first_frameimage、任意、最大 1 個jpg、jpeg、pngサイズ上限 10 MB。幅 300–100000 px。高さ 300–100000 px
last_frameimage、任意、最大 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.modestringいいえoff、onoff
duration.modestringいいえautoauto
duration.secondsintegerいいえ指定しない。3–10 秒の参照動画に追従なし
output.formatstringいいえmp4mp4
output.resolutionstringいいえ720p、1080p720p
promptstringはい文字列なし
watermarkbooleanいいえfalsefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
reference_imageimage、1 個(必須)jpg、jpeg、pngサイズ上限 10 MB。幅 300–16384 px。高さ 300–16384 px
reference_videovideo、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 を呼び出す際は、このページのフィールドとリアルタイムのモデルカタログで該当する操作を確認してください。