AIREITERNo basta con cambiar el nombre del modelo para actualizar sin riesgos una petición de Kling 2.6. Kling 3.0 ya está disponible oficialmente, pero las rutas V3, Turbo, Omni y Motion Control tienen capacidades y esquemas distintos. La migración más segura empieza por elegir la ruta adecuada y añade después, de uno en uno, los controles de audio, multishot y referencias.
Elige el endpoint antes de empezar a programar
La guía oficial de Kling para VIDEO 3.0 presenta esta versión como sucesora de VIDEO 2.6 y VIDEO O1: VIDEO 2.6 evoluciona a VIDEO 3.0, mientras que VIDEO O1 pasa a VIDEO 3.0 Omni. La API para desarrolladores ofrece operaciones independientes según el modelo, así que «API de Kling 3.0» describe una familia de acceso, no un único cuerpo de petición universal.
| Objetivo | Empieza por | Motivo | Precaución principal |
|---|---|---|---|
| Vídeo cinematográfico guiado por prompt | Kling 3.0 / V3 | Es el sucesor directo de 2.6, con dirección multishot y resultados de 3 a 15 segundos | Confirma el esquema del endpoint activo antes de copiar campos de un proveedor alojado |
| Mayor velocidad en texto a vídeo | Kling 3.0 Turbo | Kling presenta Turbo como la versión más rápida de 3.0; las referencias de la API documentan 720p y 1080p | No des por hecho que todas las funciones de audio o 4K de 3.0 estándar estén disponibles en Turbo |
| Consistencia basada en vídeo o elementos | Kling 3.0 Omni | La línea Omni es la sucesora declarada de O1 y está orientada a un control multimodal más avanzado | V3 y Omni no son IDs de modelo intercambiables |
| Animar un sujeto a partir de un movimiento de referencia | Kling Motion Control | Es una capacidad especializada de control de movimiento | Trátala como una operación específica, no como un interruptor genérico motion_control: true en cualquier payload de texto a vídeo |
El error de integración más habitual consiste en mezclar el esquema simplificado de un proveedor con el esquema directo de Kling: una petición alojada de Krea que funciona es un ejemplo práctico, no una prueba de que la misma URL o los mismos campos sirvan para la documentación oficial para desarrolladores de Kling.
Para una visión más amplia de las rutas disponibles, consulta la guía de integración de la API de Kling. Este artículo se centra en la migración a Kling 3.0 y el comportamiento de sus endpoints.
Qué cambia al pasar de Kling 2.6 a 3.0
La guía de modelos de primera parte de Kling describe la mejora relevante en términos de control, continuidad y dirección audiovisual; no se trata simplemente de un ajuste de mayor resolución. La siguiente tabla recoge las capacidades que Kling atribuye a esta familia de modelos.
| Capacidad | Kling VIDEO 2.6 | Kling VIDEO 3.0 |
|---|---|---|
| Texto a vídeo | Sí | Sí |
| Imagen a vídeo | Sí | Sí |
| Fotogramas inicial y final | Sí | Sí |
| Generación multishot | No | Sí |
| Fotograma inicial más referencia de elemento | No | Sí |
| Correferencia de varios personajes para tres o más personajes | No | Sí |
| Diálogo en chino, inglés, japonés, coreano y español | No | Sí |
| Dialectos y acentos | No | Sí |
| Duración flexible de 3 a 15 segundos | No | Sí |
En la práctica, una integración de 2.6 basada en un único prompt breve puede convertirse en una secuencia dirigida en 3.0. La guía de Kling también afirma que conserva mejor los personajes, objetos y detalles de escena durante los movimientos de cámara, aunque no publica un benchmark independiente de consistencia. Conviene distinguir esa afirmación de lo que tu aplicación pueda comprobar en sus propias pruebas.
La integración asíncrona más sencilla con Krea
La generación de vídeo es asíncrona. Tu aplicación debe enviar el trabajo, guardar el identificador de tarea, consultar su estado o recibir un callback y persistir el resultado completado. No mantengas abierta la petición HTTP original mientras el modelo renderiza.
El ejemplo siguiente utiliza el endpoint público de Kling 3.0 documentado por Krea porque en su guía de la API de Kling 3.0 aparecen tanto la petición como los campos del trabajo. Sustituye la URL y los nombres de campo propios del proveedor únicamente después de revisar el esquema oficial de Kling que vayas a utilizar.
Envía el trabajo de generación
import os
import time
import requests
API_KEY = os.environ["KREA_API_KEY"]
BASE_URL = "https://api.krea.ai"
payload = {
"prompt": (
"A paper boat crosses a rain-filled city gutter at night, "
"macro camera, practical street lights, realistic water movement"
),
"duration": 5,
"mode": "std",
"aspect_ratio": "16:9",
}
response = requests.post(
f"{BASE_URL}/generate/video/kling/kling-3.0",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=30,
)
response.raise_for_status()
job = response.json()
job_id = job["job_id"]
print(f"submitted {job_id}")La respuesta documentada por Krea incluye un job_id y un estado inicial como scheduled. El ejemplo del proveedor emplea un endpoint independiente de consulta de trabajos para comprobar el estado. Antes de iniciar el polling, guarda en tu base de datos el ID del trabajo junto con tu propio ID de pedido.
Haz polling con límite de tiempo y guarda el resultado
TERMINAL = {"completed", "failed", "cancelled"}
for attempt in range(60):
status_response = requests.get(
f"{BASE_URL}/jobs/{job_id}",
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=30,
)
status_response.raise_for_status()
job = status_response.json()
status = job.get("status")
if status in TERMINAL:
break
time.sleep(5)
else:
raise TimeoutError(f"Kling job did not finish: {job_id}")
if job["status"] != "completed":
raise RuntimeError(f"Kling job ended as {job['status']}: {job_id}")
video_url = job["result"]["urls"][0]
print(video_url)Los ejemplos de Krea tardaron 51 segundos y 2 minutos 3 segundos, así que usa límites de tiempo que tengan en cuenta la cola en lugar de prometer un tiempo de generación fijo para Kling.
En producción, un webhook puede evitar el polling repetido. Comprueba que el ID del trabajo corresponde a uno creado por tu sistema, haz que el manejador sea idempotente y no consideres que un callback sin firma demuestra por sí solo la identidad del emisor.
Incorpora los controles de 3.0 de uno en uno
Los nombres de los parámetros varían entre la API directa de Kling y los proveedores alojados. Crea una pequeña capa de compatibilidad en vez de dejar que el JSON específico de cada proveedor se propague por toda la aplicación.
| Intención | Control habitual de 3.0 | Qué comprobar |
|---|---|---|
| Dirección mediante prompt | prompt | Longitud máxima y compatibilidad con gramática de planos |
| Duración del clip | duration | La guía de la familia Kling indica de 3 a 15 segundos; verifica la ruta elegida |
| Formato de imagen | aspect_ratio | Entre los valores habituales están 16:9 y 9:16; algunas referencias también incluyen 1:1 |
| Nivel de calidad o salida | mode o resolution | Krea asocia std, pro y 4k a niveles de salida; Kling directo puede usar otro esquema |
| Sonido | generate_audio o un campo de audio específico de la ruta | Si el audio es opcional, está incluido o se cobra por separado |
| Secuencia dirigida | multi_prompt o sintaxis de planos | Si el proveedor acepta un array, gramática en el prompt o un indicador multi_shot |
| Referencia de movimiento | Operación específica de Motion Control | Medio de entrada, ID de modelo y esquema de salida; no presupongas un booleano universal |
La guía oficial contempla audio nativo, referencias de elementos, narrativas multishot y cinco idiomas de diálogo concretos. El endpoint de API que elijas puede exponer solo una parte de esas capacidades de la familia.
Un payload multishot personalizado
El esquema documentado por Krea usa bloques multi_prompt con duración. Es un patrón útil para una integración alojada:
{
"multi_prompt": [
{
"prompt": "Wide shot: a lighthouse stands on a calm rocky coast at dusk.",
"duration": 4
},
{
"prompt": "Storm clouds arrive; waves rise and spray crosses the rocks.",
"duration": 4
},
{
"prompt": "Night rain begins as the lighthouse beam sweeps toward camera.",
"duration": 4
}
],
"duration": 12,
"generate_audio": true,
"mode": "std",
"aspect_ratio": "16:9"
}Valida que la duración de nivel superior coincida con la suma de las duraciones de cada bloque. Krea informa de un resultado de 12.04 segundos para una prueba de tres bloques y 12 segundos, así que no supongas que la duración del archivo será exacta al milisegundo desde el punto de vista matemático.
Cada bloque de Krea está limitado a 512 caracteres y la secuencia dirigida completa tiene un máximo de 15 segundos. Redacta cada bloque como una indicación de plano —sujeto, cambio y cámara—, no como una larga descripción de escena. Si tu ruta directa de Kling usa en su lugar la gramática oficial de planos, conserva el mismo modelo de línea temporal y traduce el payload en el límite del adaptador.
Límites de audio e idiomas
La guía oficial enumera chino, inglés, japonés, coreano y español entre los idiomas de diálogo compatibles, y menciona dialectos, acentos, diálogos específicos por personaje y escenas multilingües. Indica que los diálogos en idiomas no compatibles se traducen al inglés, por lo que las aplicaciones multilingües no deben asumir que todo idioma de origen se conservará intacto.
El audio también es una decisión de coste. Las tarifas publicadas por Krea sitúan std en $0.1764 por segundo sin audio y $0.2646 con audio; pro cuesta $0.2352 sin audio y $0.3528 con audio. La tarifa indicada para 4K es $0.441 por segundo, con o sin audio. Son precios de Krea, no una tarifa universal de la API de Kling.
Un ciclo de iteración razonable consiste en renderizar primero borradores sin sonido y activar el audio solo para el candidato final en std o pro.
Lo que debes controlar en producción: coste, velocidad y fallos
La guía oficial de Kling para consumidores fija VIDEO 3.0 en 6 créditos por segundo para 720p sin audio nativo, 8 créditos por segundo para 1080p sin audio nativo, 9 créditos por segundo para 720p con audio y 12 créditos por segundo para 1080p con audio. Voice Control añade 2 créditos por segundo. Estas cifras explican el coste relativo dentro de esa guía; no deben convertirse en un precio en dólares de la API para desarrolladores sin consultar la página de precios para desarrolladores vigente.
La decisión no se reduce a «qué modelo es más barato». También implica facturación y operación:
| Carga de trabajo | Ruta inicial recomendable | Motivo |
|---|---|---|
| Prueba breve de integración | Ruta alojada de pago por uso | Evita un compromiso prepago elevado mientras el esquema de petición sigue cambiando |
| Volumen predecible solo con Kling | Plataforma oficial para desarrolladores | El acceso directo y las condiciones oficiales pueden pesar más que la comodidad |
| Varios proveedores de modelos de vídeo | Agregador o gateway unificado | Una única capa de autenticación y facturación puede reducir el trabajo de integración |
| Animación de personajes guiada por movimiento | Ruta Motion Control | El problema de entrada y control es distinto del texto a vídeo convencional |
Gestiona los errores por categorías:
- Reintenta los errores transitorios del proveedor con backoff exponencial limitado.
- No reintentes parámetros no válidos hasta que el adaptador corrija el payload.
- Mantén una clave de idempotencia o un ID de pedido del lado del cliente para que un timeout de red no cree un trabajo duplicado sin que lo detectes.
- Establece un límite estricto de dólares o créditos para la generación por lotes.
- Descarga o copia el resultado a un almacenamiento duradero antes de que expire la URL temporal del proveedor.
- Registra juntos la variante de modelo, duración, ajuste de audio, nivel de resolución y proveedor; «Kling 3.0» por sí solo no basta para contabilizar costes.
Checklist para migrar de Kling 2.6 a 3.0
- Haz inventario de las llamadas actuales a 2.6. Registra IDs de modelo, entradas de imagen, fotogramas inicial/final, duración, audio y comportamiento de callbacks.
- Elige la ruta de la familia 3.0. Usa V3 para generación cinematográfica guiada por prompt, Turbo para la ruta más rápida, Omni para la vía multimodal al estilo O1 y Motion Control para trabajos con referencias de movimiento.
- Crea un adaptador de proveedor. Mantén los esquemas de Kling directo, Krea y otros servicios alojados detrás de traductores separados.
- Migra primero la petición mínima. Prueba una generación silenciosa de cinco segundos en 16:9 antes de añadir controles de audio o multishot.
- Añade un control por prueba. Valida primero la duración, después el audio, luego la dirección de planos y finalmente las referencias. Así será más sencillo aislar un campo problemático.
- Prueba los estados terminales. Cubre los casos de éxito, error, cancelación, timeout, callback duplicado y URL de salida expirada.
- Ejecuta un lanzamiento en sombra con costes medidos. Compara un conjunto fijo de prompts entre 2.6 y 3.0 con la misma duración y nivel de salida, y decide después si la ganancia de calidad o control justifica la nueva ruta.
La migración estará completa cuando tu aplicación pueda revertir el ID de modelo sin modificar la lógica de negocio, los controles de facturación ni el tratamiento de resultados.
Preguntas frecuentes sobre la API de Kling 3.0
¿Existe una API oficial de Kling 3.0?
Sí. La documentación oficial para desarrolladores de Kling expone páginas de API específicas para modelos 3.0, y la guía de primera parte de Kling presenta VIDEO 3.0 como sucesor de VIDEO 2.6. El esquema exacto del endpoint debe consultarse en la consola de desarrolladores activa porque algunas páginas se renderizan en el cliente.
¿Motion Control es un parámetro de Kling 3.0?
No des por hecho que lo sea. Motion Control es una capacidad especializada con su propia página de modelo en el ecosistema de Kling. Utiliza la operación y el esquema de entrada documentados por el proveedor que hayas elegido, en vez de añadir un campo motion_control sin verificar a una petición estándar de texto a vídeo.
¿Qué duración puede generar Kling VIDEO 3.0?
La guía oficial de modelos de Kling indica que VIDEO 3.0 admite una salida flexible de 3 a 15 segundos. Una ruta alojada concreta o Turbo puede imponer límites más estrictos, por lo que debes validar el endpoint elegido.
¿Kling 3.0 admite audio nativo?
La guía oficial de VIDEO 3.0 indica que sí y describe diálogo específico por personaje, varios idiomas, dialectos y acentos. Que el audio sea opcional y cómo se facture depende del endpoint o del esquema del proveedor.
¿Kling 3.0 Omni es igual que Kling 3.0 estándar?
No. Kling presenta VIDEO 3.0 como sucesor de 2.6 y VIDEO 3.0 Omni como sucesor de O1. Las páginas de los proveedores pueden exponerlos bajo IDs de modelo distintos y con diferentes controles de referencia o voz.
¿Una suscripción web de Kling sirve para pagar llamadas a la API?
Considera las suscripciones de consumo y la facturación de la API para desarrolladores como sistemas separados hasta que la documentación vigente de la cuenta indique lo contrario. La ruta de API suele requerir su propia cuenta de desarrollador, clave y configuración de facturación.
El límite de migración útil es sencillo: conserva el ciclo de vida de los trabajos de la integración 2.6, sustituye el adaptador específico del modelo y verifica cada control nuevo de 3.0 frente a la ruta que realmente lo ofrece. Así evitarás el tipo de fallo más caro: una integración que envía trabajos correctamente, pero utiliza silenciosamente la variante, el modo de audio o el nivel de facturación equivocados.