Cómo usar la API de Kling 4.0: modos, fotogramas clave, referencias, editar y extender

Para usar la API de Kling 4.0, crea una clave de API, envía por POST un cuerpo JSON con el ID de modelo kling-4-0 y tu prompt, y sondea la tarea que devuelve hasta que la URL del vídeo esté lista. El mismo endpoint cubre los cinco modos: texto a vídeo, vídeo de imagen con hasta 10 fotogramas, referencias de imágenes, vídeos y audio, edición de un vídeo y extensión de uno. Los medios que envías y un campo, omni_reference_task_type, deciden qué modo se ejecuta.

Esta guía recorre cada modo con cuerpos de solicitud que se ejecutaron el 22 de octubre de 2026, luego muestra cómo se factura cada modo y qué solicitudes se rechazan antes de que se cobre nada.

¿Qué necesitas antes de la primera solicitud?

1. Una clave de API. Crea una en la página de claves de API y guárdala en tu servidor. Nunca la pongas en código del navegador.
2. Créditos. Añade saldo en la página de facturación. Los créditos nunca caducan y las tareas fallidas no se cobran.
3. El ID de modelo kling-4-0.

export SEEDROUTER_API_KEY="your-key"

¿Cómo se envía una solicitud de Kling 4.0?

Envía la tarea por POST a /v1/videos/generations:

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4-0",
    "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, signs shimmering in the puddles, the camera tracking low beside her. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

La respuesta es una tarea, no un vídeo:

{"id": "task_...", "model": "kling-4-0", "status": "processing", "created_at": 1789689600}

Todos los campos salvo model y, en la mayoría de los modos, prompt tienen un valor por defecto:

No hay interruptor de sonido: cada clip de Kling 4.0 viene con una pista estéreo. Tampoco hay campo mode, negative_prompt o watermark. El esquema es estricto, así que un campo desconocido se rechaza con HTTP 400 antes de crear una tarea y una errata nunca acaba en un clip pagado con la configuración silenciosamente ignorada.

¿Cómo se obtiene el vídeo?

Sondea GET /v1/tasks/{id} cada 10 a 20 segundos hasta que status sea completed o failed. Nuestras cinco ejecuciones de prueba tardaron entre 2 minutos 41 segundos y 4 minutos 22 segundos para clips de 3 segundos en 720p, así que planifica minutos, no segundos.

import os
import time
import requests

API = "https://api.seedrouter.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"}

task = requests.post(
    f"{API}/videos/generations",
    headers=HEADERS,
    json={
        "model": "kling-4-0",
        "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, no text, no logos.",
        "duration": 5,
    },
    timeout=60,
)
task.raise_for_status()
task_id = task.json()["id"]

while True:
    result = requests.get(f"{API}/tasks/{task_id}", headers=HEADERS, timeout=60).json()
    if result["status"] in ("completed", "failed"):
        break
    time.sleep(15)

if result["status"] == "completed":
    print(result["output"]["video_url"])
else:
    print(result["error"])

Una tarea terminada tiene este aspecto:

{
  "id": "task_...",
  "model": "kling-4-0",
  "status": "completed",
  "output": {"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"}
}

Este es el clip que la primera solicitud en esta página produjo, 5 segundos en 720p:

Kling 4.0, texto a vídeo, 720p, 5 segundos, con sonido estéreo.

Nuestros clips en 720p volvieron como MP4 (H.264) a 1280 × 720 con una pista AAC estéreo. Descarga el archivo a tu propio almacenamiento: los enlaces alojados no son permanentes. Un agotamiento de tiempo de espera de red mientras sondea no significa que la generación falló, así que guarda el ID de tarea y compruébalo de nuevo en lugar de enviar una nueva tarea.

¿Qué modo ejecuta una solicitud de Kling 4.0?

Los medios en el cuerpo eligen el modo. omni_reference_task_type lo hace explícito donde los medios solos serían ambiguos:

Los fotogramas y medios de referencia no pueden mezclarse en una solicitud, y un video_url sin edit o extend se rechaza. Ambos vuelven como HTTP 400 antes de que existe una tarea.

¿Cómo fijas fotogramas clave en Kling 4.0?

Envía image_with_roles, una lista de objetos {url, role}. Exactamente un first_frame, un last_frame opcional y hasta 8 entradas keyframe, 10 imágenes en total. Los fotogramas clave se usan en el orden que los enumeras, así que la lista es la línea de tiempo.

{
  "model": "kling-4-0",
  "prompt": "A girl walks from the window to the door, then looks back and smiles",
  "image_with_roles": [
    {"url": "https://example.com/1.png", "role": "first_frame"},
    {"url": "https://example.com/2.png", "role": "keyframe"},
    {"url": "https://example.com/3.png", "role": "last_frame"}
  ],
  "duration": 10
}

Para solo un comienzo y un final, image_urls: [first, last] es más corto. Vídeo de imagen es el único modo donde prompt puede omitirse; el clip toma la forma del primer fotograma.

¿Cómo utilizas referencias de imagen, vídeo y audio?

Añade video_urls (hasta 5 clips, 30 segundos usados en total), audio_urls (hasta 3 clips de 5 a 30 segundos) e imágenes de referencia, como máximo 15 archivos en total. Menciónalos en el prompt como @Image1, @Video1 y @Audio1, numerados desde 1 en cada lista:

{
  "model": "kling-4-0",
  "prompt": "The woman from @Image1 walks along the deck of the sailboat from @Video1 at sunset",
  "image_with_roles": [{"url": "https://example.com/woman.png", "role": "reference_image"}],
  "video_urls": ["https://example.com/boat.mp4"],
  "aspect_ratio": "auto",
  "duration": 5
}

Las imágenes de referencia también pueden ir en image_urls, pero solo con omni_reference_task_type: "reference"; sin él, image_urls se leen como primeros y últimos fotogramas. El propio sonido de un vídeo de referencia se reemplaza por defecto; establece audio_setting: "origin" para mantenerlo.

¿Cómo editas un vídeo con Kling 4.0?

Establece omni_reference_task_type en edit, pasa el vídeo en video_url y describe el cambio. Hasta 10 imágenes de referencia pueden ir en image_urls.

{
  "model": "kling-4-0",
  "prompt": "Change the scene to a snowy winter evening with falling snow",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/in.mp4"
}

La entrada debe durar al menos 3 segundos y solo se usan sus primeros 30 segundos. Omite duration y el resultado sigue la duración del vídeo de entrada; el sonido original se mantiene a menos que establezcas audio_setting: "auto".

¿Cómo extiendes un vídeo?

Establece omni_reference_task_type en extend, pasa el vídeo y da duration como la duración de la nueva parte. Kling 4.0 continúa desde el último fotograma y devuelve el original más los segundos nuevos como un archivo. En nuestra prueba, un clip de 5,2 segundos extendido por 3 segundos volvió 8,1 segundos.

{
  "model": "kling-4-0",
  "prompt": "The sailboat keeps gliding forward as the sun sets below the horizon",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 3
}

Añade last_frame_image para elegir dónde termina la nueva parte. La extensión mantiene la proporción y el sonido de la entrada, así que aspect_ratio y audio_setting se rechazan.

¿Cuánto cuesta una solicitud de Kling 4.0?

Kling 4.0 se factura por segundo de vídeo a una tarifa establecida por la resolución. Los segundos que cuentan dependen del modo:

La entrada es la duración combinada de los vídeos de entrada, redondeada al alza a segundos completos y limitada a 30. Se mide cuando se acepta la solicitud, así que la cantidad reservada es la cantidad cobrada. En nuestra prueba de edición, una entrada de 5,2 segundos y un resultado de 3 segundos facturaron 3 + 6 = 9 segundos. Estas son las tarifas actuales:

Un vídeo cuya duración no se puede leer se rechaza antes de que se cobre nada, y una tarea que falla no se cobra.

¿Qué solicitudes se rechazan antes de que se cobre nada?

Estas vuelven como HTTP 400 en el envío, sin tarea creada y nada cobrado:

Una tarea que se acepta y luego falla, por ejemplo en la política de contenido del modelo, devuelve status: "failed" con un código error y no se cobra. El catálogo de errores lista los códigos.

¿Puede un agente de codificación ejecutarlo por ti?

Sí. La página de Kling 4.0 tiene un prompt listo para Claude Code, Codex o Cursor que lee la clave de tu entorno, te muestra la solicitud y su coste, espera tu aprobación, luego envía, sondea y descarga el clip. La misma página tiene un playground que envía el cuerpo exacto que tu código haría, con todos los campos agrupados por modo.

Preguntas sobre la API de Kling 4.0

¿Es la API de Kling 4.0 gratis?

No. Se factura por segundo de vídeo. Las cuentas nuevas de SeedRouter obtienen un pequeño crédito para probarlo, no hay suscripción y las tareas fallidas no se cobran.

¿Kling 4.0 Flash está en la API?

Todavía no. Kling 4.0 Flash es un modelo más ligero e independiente en la misma familia; Kling lo enumera con clips más cortos en 720p y sin múltiples fotogramas clave.^[1] El ID de modelo kling-4-0 es el Kling 4.0 completo.

¿En qué se diferencia Kling 4.0 de Kling 3.0 en la API?

Kling 4.0 hace clips de hasta 30 segundos, toma fotogramas clave, referencias de vídeo y audio, y puede editar o extender un vídeo; el sonido siempre está activado. Kling 3.0 hace clips de 3 a 15 segundos, ofrece 4K, prompts multitoma y elementos nombrados, y tiene un interruptor de sonido. La guía de API de Kling 3.0 cubre sus campos. Kling anunció 4.0 con su duración de 30 segundos, 10 fotogramas clave y sonido estéreo el 30 de septiembre de 2026.^[2]

¿Puedo cancelar una tarea?

No. Una vez aceptada, una tarea se ejecuta hasta completarse o fallar. Las tareas fallidas no se cobran.

Referencias

1. Kling AI. Kling 4.0 video generation (resumen de funciones y preguntas frecuentes). Consultado el 8 de octubre de 2026 en kling.ai.
2. Kling AI. Introducing Kling 4.0: Visual Realism, Creative Control, and Next-Level Storytelling. 30 de septiembre de 2026. Consultado el 8 de octubre de 2026 en kling.ai.