主体を作成

POST

/kling/v1/general/advanced-custom-elements

カスタム主体を作成し、以降の動画生成などで利用します。

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

20文字以内。

100文字以内。

列挙値：video_refer、image_refer

• video_refer：動画キャラクター主体。外見は element_video_list で定義
• image_refer：複数画像主体。外見は element_image_list で定義
  動画と画像で作成した主体の利用範囲は異なります。能力マップとパラメータ説明を参照してください。

object

複数画像で主体と細部を設定できます。

正面参照とその他の角度・クローズアップ参照を含みます。正面は frontal_image で少なくとも1枚。正面と異なる参照画像を image_url で1～3枚。

key:value 形式の例：

"element_image_list": {
"frontal_image": "image_url_0",
"refer_images": [{ "image_url": "image_url_1" }, ...]
}

画像の Base64 またはアクセス可能な URL を指定できます。

形式：.jpg / .jpeg / .png。最大 10MB、最小 300px、縦横比 1:2.5～2.5:1。

reference_type が image_refer の場合は必須。

object

動画で主体と細部を設定できます。

音声付き動画をアップロード可能。人の声が含まれる場合は音色カスタマイズ（学習・ライブラリ登録・主体への紐付け）がトリガーされます。

現時点では動画からの写実的な人型主体のみ対応。

動画参照時は必須。画像参照時は無効。

key:value 形式。形式は MP4/MOV のみ。長さ 3～8 秒、16:9 または 9:16、1080p。最大1本、200MB 以下。video_url は空不可。

"element_video_list": {
"refer_videos": [{ "video_url": "video_url_1" }, ...]
}

動画主体は kling-video-o3 以降のモデルのみ対応。

音色ライブラリの既存音色を紐付けできます。

空の場合は音色を紐付けません。

音色関連 API で ID を取得できます。

動画主体のみ音色の紐付けに対応。

object[]

1つの主体に複数タグを設定できます。

key:value 形式。タグ ID と名称：o_101 ミーム, o_102 人物, o_103 動物, o_104 小道具, o_105 衣装, o_106 シーン, o_107 エフェクト, o_108 その他

タスク状態変更時のコールバック URL（設定時）。

呼び出し元のタスク ID。システム ID は上書きしませんが、この ID で照会できます。ユーザーごとに一意にしてください。