Saltar al contenido principal
POST
Este endpoint es asíncrono. Tras enviar la solicitud, usa el task_id devuelto con GET /v1/tasks/{task_id} para consultar el estado y el resultado.

​
Selección del modo

Los cinco modos usan el mismo modelo, kling-v4-flash. El modo se selecciona según los recursos enviados y omni_reference_task_type. omni_reference_task_type usa auto por defecto, equivalente a omitirlo. Con reference explícito, las imágenes de image_urls se tratan como referencias.
Enviar solo video_url sin indicar edit o extend devuelve HTTP 400. Para usar un vídeo como referencia, utiliza video_urls.

​
Cabeceras de la solicitud

​
string
requerido
Autenticación Bearer: Bearer <token>, donde <token> es tu clave API de APIMart.

​
Parámetros de la solicitud

​
string
requerido
Debe ser kling-v4-flash.
​
string
Describe el contenido que se generará o editará. Opcional solo en imagen a vídeo. Usa @Image1 / @Video1 para referirte a los recursos, numerados desde 1 en cada array. En edición, el vídeo de entrada es @Video1 y las imágenes son @Image1, @Image2, etc.
​
integer
Segundos enteros de 3 a 20, normalmente 5 por defecto. Al editar, si se omite, se usa la duración de entrada redondeada hacia arriba. Al extender, indica el segmento añadido. 0 explícito devuelve HTTP 400; null equivale a omitirlo. Se factura este entero; el archivo puede durar aproximadamente un fotograma más.
​
integer
Alias de duration, con las mismas reglas. Si se envían ambos, cada valor debe estar entre 3 y 20 y ser idéntico al otro; en caso contrario, HTTP 400.
​
string
predeterminado:"720p"
Solo 720p, valor por defecto. 1080p devuelve HTTP 400. No se admite seleccionar un nivel mediante mode.
​
string
La generación desde texto, con referencias y la edición admiten 16:9, 9:16, 1:1 y 21:9; solo la generación con referencias acepta auto. La generación desde una imagen no admite aspect_ratio / size: los valores no vacíos devuelven HTTP 400; una cadena vacía equivale a omitir el campo. Recorta el fotograma inicial antes del envío para cambiar la proporción.
​
string[]
Imagen a vídeo acepta una sola imagen inicial; dos devuelven HTTP 400. En referencias y edición se admiten hasta 10 imágenes de referencia. Para referencias solo de imágenes, indica omni_reference_task_type: "reference". Las URL deben ser públicas. Los fotogramas iniciales y las imágenes de referencia deben tener al menos 300px de ancho y alto, con una proporción ancho:alto entre 2:5 y 5:2. Las imágenes fuera de estos límites devuelven HTTP 400 al enviar la solicitud, sin cobro.
​
object[]
Cada elemento incluye url y role. Imagen a vídeo acepta un único first_frame; referencias y edición usan reference_image. No se admiten fotogramas finales ni intermedios. Máximo 10 imágenes de referencia y 15 recursos en total, incluidos los vídeos. Los fotogramas iniciales y las imágenes de referencia deben tener al menos 300px de ancho y alto, con una proporción ancho:alto entre 2:5 y 5:2. Las imágenes fuera de estos límites devuelven HTTP 400 al enviar la solicitud, sin cobro.
​
string
URL del fotograma inicial para imagen a vídeo. También puede enviarse como first_frame en image_with_roles o como primera imagen de image_urls. Los fotogramas iniciales y las imágenes de referencia deben tener al menos 300px de ancho y alto, con una proporción ancho:alto entre 2:5 y 5:2. Las imágenes fuera de estos límites devuelven HTTP 400 al enviar la solicitud, sin cobro.
​
string[]
Hasta 5 vídeos de referencia y 20 segundos en total. Superar el límite devuelve HTTP 400; no se recortan. En edición o extensión, una única entrada puede sustituir a video_url si se indica el tipo de tarea correspondiente.Los vídeos de referencia deben ser MP4 / MOV, con anchura y altura entre 700 y 4553px cada una. La duración se mide por el flujo de vídeo, no por el contenedor: mínimo 3 segundos por clip y máximo 20 segundos en total. Cualquier vídeo de referencia de menos de 3 segundos devuelve HTTP 400 al enviar la solicitud, sin cobro.
​
string
Vídeo de entrada para edición o extensión. Requiere omni_reference_task_type: "edit" o "extend" explícito, o devuelve HTTP 400. La entrada de edición debe durar 3–20 segundos. Fuera de ese rango se rechaza sin cargo.La edición admite vídeos MP4 / MOV con anchura y altura entre 700 y 4553px cada una. El límite de 3–20 segundos se basa en el flujo de vídeo, no en el contenedor. Un formato, anchura, altura o duración de entrada no válidos devuelven HTTP 400 al enviar la solicitud, sin cobro.Las entradas de extensión no están sujetas al intervalo de altura ni al mínimo de 3 segundos de la edición. Por ejemplo, se puede extender un vídeo 480p de 2 segundos.
​
string
predeterminado:"auto"
Admite auto, reference, edit y extend.
  • auto: selecciona texto a vídeo, imagen a vídeo o generación con referencias según los recursos; equivale a omitir el campo.
  • reference: generación con referencias; las imágenes de image_urls se tratan como referencias.
  • edit: edición de vídeo; requiere un vídeo de entrada.
  • extend: extensión de vídeo; requiere un vídeo de entrada.
​
string
Para generación con referencias de vídeo: origin conserva el audio del primer vídeo de referencia; auto genera audio nuevo y es el valor predeterminado. origin requiere un vídeo de referencia. Si el primero no tiene pista de audio, la salida tampoco tendrá. La edición genera audio nuevo y no conserva el original; omite este parámetro en las solicitudes de edición. La extensión no lo admite.

​
Dimensiones de salida y frecuencia de fotogramas

La salida utiliza el nivel 720p, con dimensiones reales en píxeles que varían según la proporción, a 24fps. El archivo puede durar aproximadamente un fotograma más que duration; por ejemplo, una solicitud de 3 segundos produce unos 3.04 segundos.

​
Ejemplos de solicitudes

Las URL siguientes son ejemplos ficticios. Sustitúyelas por URL reales y accesibles públicamente.

​
Imagen a vídeo: un único fotograma inicial

Proporciona una sola imagen inicial; prompt es opcional. No se admiten fotogramas finales, intermedios ni una segunda imagen. Omite aspect_ratio / size; sigue el fotograma inicial. Recórtalo antes del envío para cambiar la proporción. Los fotogramas iniciales y las imágenes de referencia deben tener al menos 300px de ancho y alto, con una proporción ancho:alto entre 2:5 y 5:2. Las imágenes fuera de estos límites devuelven HTTP 400 al enviar la solicitud, sin cobro.

​
Generación con referencias

Hasta 10 imágenes y 5 vídeos de referencia, con un total máximo de 15 recursos. Los vídeos deben sumar como máximo 20 segundos. No se admite audio de referencia. Añade audio_setting: "origin" para conservar el audio del primer vídeo de referencia. Con origin, si el primer vídeo de referencia no tiene pista de audio, la salida tampoco tendrá. Los fotogramas iniciales y las imágenes de referencia deben tener al menos 300px de ancho y alto, con una proporción ancho:alto entre 2:5 y 5:2. Las imágenes fuera de estos límites devuelven HTTP 400 al enviar la solicitud, sin cobro. Los vídeos de referencia deben ser MP4 / MOV, con anchura y altura entre 700 y 4553px cada una. La duración se mide por el flujo de vídeo, no por el contenedor: mínimo 3 segundos por clip y máximo 20 segundos en total. Cualquier vídeo de referencia de menos de 3 segundos devuelve HTTP 400 al enviar la solicitud, sin cobro.

​
Edición de vídeo

El flujo de vídeo de la entrada de edición debe durar 3–20 segundos. Sin duration, la duración de entrada se redondea hacia arriba; sin aspect_ratio, se conserva la proporción de entrada. La edición genera audio nuevo sin conservar el original. Omite audio_setting en la solicitud. Los fotogramas iniciales y las imágenes de referencia deben tener al menos 300px de ancho y alto, con una proporción ancho:alto entre 2:5 y 5:2. Las imágenes fuera de estos límites devuelven HTTP 400 al enviar la solicitud, sin cobro. La edición admite vídeos MP4 / MOV con anchura y altura entre 700 y 4553px cada una. El límite de 3–20 segundos se basa en el flujo de vídeo, no en el contenedor. Un formato, anchura, altura o duración de entrada no válidos devuelven HTTP 400 al enviar la solicitud, sin cobro.

​
Extensión de vídeo

Genera un segmento nuevo de 3–20 segundos desde el último fotograma de la entrada y devuelve solo ese segmento, sin el vídeo original. Se cobra la duración del segmento nuevo. No se admiten imágenes, un fotograma final objetivo, aspect_ratio ni audio_setting; se conserva la proporción original. Las entradas de extensión no están sujetas al intervalo de altura ni al mínimo de 3 segundos de la edición. Por ejemplo, se puede extender un vídeo 480p de 2 segundos.

​
Consultar una tarea

Sustituye el ID de tarea de la siguiente solicitud por el devuelto al enviarla:
Usa la consulta de tareas. Guarda task_id y consulta hasta completed o failed. Un vídeo 720p de 3 segundos tardó unos 1–4 minutos en las pruebas; es una referencia, no un plazo fijo para declarar un fallo.

​
Facturación

Se factura por segundo; consulta los precios de modelos. La generación estándar y la entrada de vídeo usan tarifas distintas. Los segundos de entrada se calculan sumando las duraciones de los flujos de vídeo y redondeando después hacia arriba, no usando las duraciones de los contenedores. Editar un vídeo de 3.04 segundos con duration: 3 se cobra como 3 + 4 = 7 segundos. La edición y la generación con referencias de vídeo comprueban el formato, la anchura, la altura y la duración del flujo al enviar la solicitud. Un fallo de comprobación, un formato distinto de MP4 / MOV, una anchura o altura fuera de 700–4553px, un total superior a 20 segundos o una entrada de edición inferior a 3 segundos devuelven HTTP 400 sin cobro. Cada referencia se evalúa por la duración de su flujo de vídeo; los clips de menos de 3 segundos devuelven HTTP 400 al enviar la solicitud, sin cobro. Las tareas fallidas se reembolsan por completo, incluidas las que la plataforma declara agotadas por tiempo. Dejar de consultar desde el cliente no cancela la tarea; si termina correctamente después, se cobra con normalidad.

​
Parámetros no admitidos

Los siguientes parámetros o valores devuelven HTTP 400:
  • resolution: "1080p"
  • last_frame_image, role: "last_frame", role: "keyframe"
  • audio_urls, audio_url
  • mode, negative_prompt, watermark: true, audio: false
  • multi_shot, multi_prompt, element_list, video_list
  • camera_control, voice_list

​
Errores frecuentes