Omni-Video

POST

/kling/v1/videos/omni-video

Crea una tarea Omni-Video (texto a video, imagen a video, edición de video, etc.).

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Nombre del modelo. Valores: kling-video-o1, kling-v3-omni

Prompt de texto; puede incluir descripciones positivas y negativas.
Los prompts pueden plantillarse según la necesidad.
Hasta 2500 caracteres.
Obligatorio cuando multi_shot es false.

object[]

Lista de imágenes de referencia (sujeto, escena, estilo, etc.) o primer/último fotograma del video.
Como primer/último fotograma:
type: first_frame (primero), end_frame (último).
No se admite solo el último; si hay end_frame se requiere first_frame.
Primer/último fotograma no compatible con edición de video.

object[]

Video de referencia por URL.
Puede ser video de referencia (feature) o a editar (base, predeterminado); audio original opcional.
refer_type: feature = referencia, base = a editar.
Con base no se definen primer/último fotograma.
keep_original_sound: yes = conservar, no = quitar; también aplica a feature.

Modo de generación.
Valores: std, pro.
std: modo estándar, buena relación calidad/precio.
pro: modo de alta calidad.

Relación de aspecto (ancho:alto).
Valores: 16:9, 9:16, 1:1.
Obligatorio sin primer fotograma ni edición de video.

Duración en segundos.
Valores: 3, 4, 5, 6, 7, 8, 9, 10.
Texto/primer fotograma: solo 5 y 10.
Edición (refer_type base): duración igual al video de entrada, campo ignorado; facturación por segundos redondeados.
kling-v3-omni: 3–15; mismas reglas al editar.

object[]

Sujetos

Video multiplanos.
Si true, prompt se ignora.
Si false, shot_type y multi_prompt se ignoran.

Modo de segmentación.
Valor: customize.
Obligatorio si multi_shot es true.

object[]