Skip to main content
POST

認証

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

リクエストパラメータ

string
必須
動画生成モデル名サポートされているモデル:
  • kling-v3 - Kling v3(推奨)
string
必須
テキストプロンプトシーン、アクション、スタイルなどを詳しく記述すると、より良い生成結果が得られます。英語のプロンプトを推奨します。例:"a golden retriever running on the beach, sunset, cinematic"
string
ネガティブプロンプト、不要なコンテンツを除外するために使用例:"ぼやけ, 低画質, 歪み"
string
デフォルト:"std"
生成モードオプション:
  • std - スタンダードモード(720P)
  • pro - プロフェッショナルモード(1080P)
  • 4k - 4Kモード
デフォルト:std
integer
デフォルト:"5"
デフォルト:5 動画の長さ(秒)値の範囲:3-15(最短3秒、最長15秒)⚠️ 注意: 純粋な数値(例:6)を入力してください。引用符を付けるとエラーが発生します
string
デフォルト:"16:9"
動画のアスペクト比オプション:
  • 16:9 - 横向き
  • 9:16 - 縦向き
  • 1:1 - 正方形
デフォルト:16:9
array<url>
画像から動画生成用の画像URL配列
  • 1枚:先頭フレームとして使用
  • 2枚:自動的に先頭フレーム + 末尾フレームに割り当て
最大2枚まで例:["https://example.com/first.jpg"]
  • 最大2枚まで
  • 画像URLは公開アクセス可能で、ホットリンク保護がないものである必要があります
  • 画像から動画モードでは、aspect_ratio が画像の実際の比率で上書きされる場合があります
boolean
ウォーターマークを追加するかどうか
boolean
デフォルト:"false"
音声付き動画を生成するかどうか
boolean
デフォルト:"false"
マルチショットモードを有効にするかどうか。
  • true
  • false
string
分鏡方式:customize / intelligencemulti_shot=true の場合は必須です。
array<object>
各ショットの情報(プロンプト、長さなど)。indexpromptduration でショット順序・内容・長さを定義します。
  • 最小 1 ショット、最大 6 ショット
  • 各ショット内容の最大長は 512
  • 各ショットの長さは 1 以上かつタスク総時間以下
  • 全ショットの長さ合計はトップレベル duration と一致
形式:
multi_shot=true かつ shot_type=customize の場合は必須です。
array<object>
参照主体リスト。最大 3 主体まで。
  • namedescriptionelement_input_urls で現場作成可能
例:
説明:
  • 現場作成時は namedescriptionelement_input_urls が必須
  • element_input_urls:主体ごとに 2〜4 枚(1 枚目は正面、残りは参照)
  • prompt@name 形式参照(例:"@element_dog と @element_cat が芝生で追いかける"

パラメータの制約と境界

  • mode=4kkling-v3 で使用可能
  • image_urls は最大 2 枚(1 枚: 先頭、2 枚: 先頭+末尾)
  • 末尾フレームのみ入力は無効(先頭フレームが必要)
  • multi_shot=true の場合、トップレベル prompt は省略可能
  • multi_prompt は最大 6 ショット、index は 1 から連続

機能サポートマトリクス

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

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

レスポンス

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

使用シーン

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

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

シーン 3:テキストから動画(15秒)

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

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

シーン 6:音声付き動画の生成

シーン 7:マルチショット分鏡(customize、15 秒、音声付き縦画面)

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