Créer un sujet

POST

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

Crée un sujet personnalisé pour la génération vidéo et les fonctionnalités associées.

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

20 caractères maximum.

100 caractères maximum.

Valeurs : video_refer, image_refer

• video_refer : sujet personnage vidéo ; apparence définie par element_video_list
• image_refer : sujet multi-images ; apparence définie par element_image_list
  Les sujets créés par vidéo ou par images n'ont pas la même portée ; voir la carte des capacités et les paramètres.

object

Définir le sujet et ses détails avec plusieurs images.

Inclut une référence de face et d'autres angles ou gros plans : au moins une image frontale (frontal_image) ; 1 à 3 images différentes de la face (image_url).

Format key:value :

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

Images en Base64 ou URL accessibles.

Formats : .jpg / .jpeg / .png. Max. 10 Mo, min. 300 px, ratio entre 1:2,5 et 2,5:1.

Obligatoire si reference_type vaut image_refer.

object

Définir le sujet et ses détails par vidéo.

Vidéos avec son acceptées ; la voix humaine déclenche la personnalisation vocale (entraînement, bibliothèque, liaison au sujet).

Pour l'instant, uniquement sujets humains réalistes à partir de vidéo.

Obligatoire en référence vidéo ; ignoré en référence image.

Format key:value. MP4/MOV uniquement. Durée 3–8 s, 16:9 ou 9:16, 1080p. Une seule vidéo, max. 200 Mo. video_url non vide.

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

Sujets vidéo uniquement sur kling-video-o3 et modèles ultérieurs.

Lier une voix existante de la bibliothèque.

Si vide, aucune voix n'est liée.

Obtenir l'ID via les API voix.

Liaison vocale uniquement pour les sujets créés par vidéo.

object[]

Plusieurs tags par sujet.

Format key:value. ID et noms : o_101 mème, o_102 personne, o_103 animal, o_104 accessoire, o_105 costume, o_106 scène, o_107 effet, o_108 autre

URL de rappel lors des changements d'état de la tâche (si configurée).

ID de tâche défini par l'appelant. Ne remplace pas l'ID système mais permet la consultation. Unique par utilisateur.