Crear sujeto

POST

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

Crea un sujeto personalizado para generación de vídeo y funciones relacionadas.

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Máximo 20 caracteres.

Máximo 100 caracteres.

Valores: video_refer, image_refer

• video_refer: sujeto de personaje en vídeo; apariencia definida por element_video_list
• image_refer: sujeto con varias imágenes; apariencia definida por element_image_list
  Los sujetos creados por vídeo o por imágenes tienen alcances distintos; consulte el mapa de capacidades y los parámetros.

object

Definir el sujeto y sus detalles con varias imágenes.

Incluye referencia frontal y otros ángulos o primeros planos: al menos una frontal (frontal_image); 1–3 imágenes distintas de la frontal (image_url).

Formato key:value:

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

Admite imágenes en Base64 o URL accesibles.

Formatos: .jpg / .jpeg / .png. Máx. 10 MB, mín. 300 px, relación de aspecto entre 1:2,5 y 2,5:1.

Obligatorio cuando reference_type es image_refer.

object

Definir el sujeto y sus detalles con vídeo.

Se pueden subir vídeos con audio; la voz humana activa la personalización de voz (entrenamiento, biblioteca, enlace al sujeto).

Por ahora solo sujetos humanos realistas a partir de vídeo.

Obligatorio con referencia de vídeo; ignorado con referencia de imagen.

Formato key:value. Solo MP4/MOV. Duración 3–8 s, 16:9 o 9:16, 1080p. Como máximo un vídeo, 200 MB. video_url no vacío.

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

Los sujetos de vídeo solo se admiten en kling-video-o3 y modelos posteriores.

Enlazar una voz existente de la biblioteca.

Si está vacío, no se enlaza voz.

Obtener el ID mediante las API de voz.

Solo los sujetos creados por vídeo admiten enlace de voz.

object[]

Un sujeto puede tener varias etiquetas.

Formato key:value. ID y nombres: o_101 meme, o_102 persona, o_103 animal, o_104 utilería, o_105 vestuario, o_106 escena, o_107 efecto, o_108 otro

URL de callback cuando cambia el estado de la tarea (si se configura).

ID de tarea definido por el llamante. No sustituye el ID del sistema pero permite consultar la tarea. Debe ser único por usuario.