Skip to content

Omni-Video

POST
/kling/v1/videos/omni-video

Omni-Video 動画生成タスクを作成します(テキストから動画、画像から動画、動画編集など)。

Authorizations

bearer
Type
HTTP (bearer)

Request Body

application/json
object

モデル名。列挙値:kling-video-o1、kling-v3-omni

テキストプロンプト。ポジティブ・ネガティブの記述を含められます。
用途に応じてテンプレート化できます。
最大 2500 文字。
multi_shot が false のとき必須です。

object[]

参照画像リスト(被写体・シーン・スタイルなど)、または動画の先頭/末尾フレームとして使用。
先頭/末尾フレームとして使う場合:
type で first_frame(先頭)、end_frame(末尾)を指定。
末尾のみは非対応。end_frame がある場合は first_frame が必須。
先頭/末尾フレーム生成と動画編集は同時に使えません。

object[]

URL で指定する参照動画。
特徴参照動画または編集対象動画(デフォルトは編集対象)。元音声の保持を選択可能。
refer_type:feature = 特徴参照、base = 編集対象。
base のときは先頭/末尾フレームを指定できません。
keep_original_sound:yes = 保持、no = 削除。feature にも適用されます。

動画生成モード。
列挙値:std、pro。
std:標準モード。コストパフォーマンス重視。
pro:高品質モード。画質重視。

出力のアスペクト比(幅:高さ)。
列挙値:16:9、9:16、1:1。
先頭フレーム参照または動画編集を使わない場合は必須。

動画の長さ(秒)。
列挙値:3、4、5、6、7、8、9、10。
テキストから動画・先頭フレーム画像から動画では 5 と 10 のみ。
動画編集(refer_type が base)では入力動画と同じ長さになり、この項目は無効。課金は入力秒数を四捨五入。
kling-v3-omni は 3–15 をサポート。編集時のルールは同様。

object[]

被写体

マルチショット動画を生成するか。
true のとき prompt は無効。
false のとき shot_type と multi_prompt は無効。

ショット分割方式。
列挙値:customize。
multi_shot が true のとき必須。

object[]

各ショットのプロンプト・長さなど。
index、prompt、duration で定義:
最大 6 ショット、最小 1。
各ショットの内容は最大 512 文字。
各ショットの長さは 1 以上タスク総時間以下。
全ショットの長さの合計はタスク総時間と一致すること。

object

透かし付き結果も生成するか。
enabled で指定。例:
"watermark_info": { "enabled": true }
true = 生成、false = 生成しない。

動画と同時に音声を生成するか。
列挙値:on、off。

Responses

OK

application/json
object

タスク ID

タスク状態

Playground

Authorization
Body

Samples