Skip to main content
POST

認証

string
必須
すべてのAPIエンドポイントはBearer Token認証が必要ですAPIキーの取得:APIキー管理ページにアクセスしてAPIキーを取得してくださいリクエストヘッダーに追加:

リクエストパラメータ

string
必須
動画生成モデル名サポートされているモデル:
  • kling-v2-6 - Kling v2.6(推奨)
boolean
デフォルト:"false"
動画タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • trueomni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
テキストプロンプト、最大 2500 文字シーン、アクション、スタイルなどを詳しく記述すると、より良い生成結果が得られます例:"金色の猫が日差しの中の草原を走る、スローモーション、映画的な質感"
string
デフォルト:"std"
生成モードオプション:
  • std - スタンダードモード(720P、無音動画のみ)
  • pro - プロフェッショナルモード(1080P、自動音声生成をサポート)
デフォルト:std
スタンダードモードの制限std モードは無音動画のみサポートします。audio パラメータは pro モードで使用する必要があります。
integer
デフォルト:"5"
動画の長さ(秒)オプション:5 または 10デフォルト:5
string
デフォルト:"16:9"
動画のアスペクト比オプション:
  • 16:9 - 横向き
  • 9:16 - 縦向き
  • 1:1 - 正方形
デフォルト:16:9
string
ネガティブプロンプト、不要なコンテンツを除外するために使用例:"ぼやけ, 低画質, 歪み"
array<url>
画像から動画生成用の画像URL配列
  • 1枚:先頭フレームとして使用
  • 2枚:自動的に先頭フレーム + 末尾フレームに割り当て(mode: "pro" が必要)
最大2枚まで例:["https://example.com/first.jpg"]
  • 最大2枚まで
  • 末尾フレーム(2枚使用)は pro モードのみ、std モードは先頭フレーム(1枚)のみサポート
  • 末尾フレームと音声は排他的pro モードで末尾フレーム(2枚)と音声(audio: true)は同時に使用できません
  • 画像から動画モードでは、aspect_ratio が画像の実際の比率で上書きされる場合があります
boolean
デフォルト:"false"
音声を自動生成するかどうかデフォルト:false
  • mode: "pro" でのみ利用可能
  • 末尾フレームと排他的:音声を有効にすると末尾フレーム(2枚)は同時に使用できません
boolean
ウォーターマークを追加するかどうか

機能サポートマトリクス

注意pro モードで末尾フレームと音声制御は排他的で、同時に使用できません。

テキストから動画 vs 画像から動画

image_urls の有無でシステムが自動的にモードを判定します:画像なしはテキストから動画、画像ありは画像から動画。

レスポンス

integer
レスポンスステータスコード、成功時は200
array
レスポンスデータ配列

使用シーン

シーン 1:テキストから動画(スタンダードモード)

シーン 2:テキストから動画(プロモード + ネガティブプロンプト)

シーン 3:画像から動画(先頭フレーム)

シーン 4:画像から動画(先頭 + 末尾フレーム制御)

シーン 5:プロモード + 自動音声

タスク結果の照会動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータスの取得 エンドポイントで生成の進捗と結果を照会できます。