Subjekt erstellen

POST

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

Erstellt ein benutzerdefiniertes Subjekt für spätere Videogenerierung und zugehörige Funktionen.

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Maximal 20 Zeichen.

Maximal 100 Zeichen.

Werte: video_refer, image_refer

• video_refer: Video-Charakter-Subjekt; Erscheinung über element_video_list
• image_refer: Multi-Bild-Subjekt; Erscheinung über element_image_list
  Subjekte aus Video und Bild haben unterschiedliche Einsatzbereiche; siehe Fähigkeitenkarte und Parameterhinweise.

object

Subjekt und Details mit mehreren Bildern definieren.

Enthält Frontalreferenz und weitere Winkel oder Nahaufnahmen: mindestens ein Frontalbild (frontal_image); 1–3 weitere, vom Frontalbild abweichende Bilder (image_url).

Format key:value:

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

Base64-kodierte Bilder oder erreichbare URLs.

Formate: .jpg / .jpeg / .png. Max. 10 MB, min. 300 px, Seitenverhältnis 1:2,5 bis 2,5:1.

Pflicht bei reference_type = image_refer.

object

Subjekt und Details per Video definieren.

Videos mit Ton möglich; menschliche Stimme löst Stimmanpassung aus (Training, Bibliothek, Bindung ans Subjekt).

Derzeit nur realistische menschliche Subjekte aus Video.

Pflicht bei Videoreferenz; bei Bildreferenz ignoriert.

Format key:value. Nur MP4/MOV. Dauer 3–8 s, 16:9 oder 9:16, 1080p. Max. ein Video, 200 MB. video_url darf nicht leer sein.

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

Video-Subjekte nur auf kling-video-o3 und neueren Modellen.

Bestehende Stimme aus der Stimmbibliothek binden.

Wenn leer, keine Stimme gebunden.

ID über Stimmen-APIs abrufen.

Stimmbindung nur bei Video-Subjekten.

object[]

Mehrere Tags pro Subjekt möglich.

Format key:value. IDs und Namen: o_101 Meme, o_102 Person, o_103 Tier, o_104 Requisite, o_105 Kostüm, o_106 Szene, o_107 Effekt, o_108 Sonstiges

Callback-URL bei Aufgabenstatusänderungen (falls konfiguriert).

Vom Aufrufer definierte Aufgaben-ID. Ersetzt nicht die System-ID, ermöglicht aber Abfrage. Pro Benutzer eindeutig.