API de Kling 4.0 (kling-v4): parámetros, precio y código

Respuesta corta: Kling 4.0 está disponible en HopBase con el ID de modelo kling-v4. Genera de 3 a 30 segundos de video en 720p o 1080p, con relación de aspecto 16:9, 9:16, 1:1 o 21:9, a partir de un prompt de texto o de una imagen como primer fotograma. Todos los resultados incluyen pista de audio: audio: false no la elimina ni reduce el precio. La generación es una tarea asíncrona: envíala con POST https://api.hop-base.com/v1/video/generate, recibe un ID de tarea que empieza por kt y consulta GET /v1/video/tasks/{task_id} hasta que el estado sea completed o failed; normalmente tarda unos minutos. El precio oficial es de $0.1471 por segundo en 720p y $0.2206 por segundo en 1080p, se cobra por segundo de video generado y las tareas fallidas no se cobran. Las imágenes de referencia, el video de referencia y 2K/4K todavía no están disponibles en kling-v4. Los enlaces de resultado son válidos durante 24 horas.

Qué aporta Kling 4.0 y cuándo seguir con Kling 3.0

Kling 4.0 se lanzó en HopBase el 2026-10-29. Frente a los modelos Kling 3.0 que puedes usar con la misma clave, permite clips más largos (hasta 30 segundos en una sola tarea, frente a 15), añade la relación cinematográfica 21:9 y siempre entrega sonido. En la entrada es más limitado: solo un prompt de texto y, opcionalmente, un primer fotograma.

	kling-v4	kling-v3	kling-v3-omni
Duración	3–30 s	3–15 s	3–15 s
Resoluciones	720p / 1080p	720p / 1080p / 2K / 4K	720p / 1080p / 2K / 4K
Relaciones de aspecto	16:9 / 9:16 / 1:1 / 21:9	16:9 / 9:16 / 1:1	16:9 / 9:16 / 1:1
Audio	Siempre incluido	Con o sin audio	Con o sin audio
Entrada de imagen	Solo primer fotograma	Primer/último fotograma, hasta 6 imágenes de referencia	Primer/último fotograma, imágenes de referencia
Video de referencia	No	No	Sí (feature)
Sujetos / multitoma shots	No	Sí	Sí
Precio oficial, 1080p con audio	$0.2206 / s	$0.1765 / s	$0.1471 / s

Elige kling-v4 para clips de más de 15 segundos, para salida 21:9 o si quieres audio en cada resultado sin gestionar el parámetro audio. Sigue con kling-v3 o kling-v3-omni si necesitas imágenes o video de referencia, personajes consistentes con sujetos personalizados, guion multitoma o 2K/4K (consulta nuestra guía de Kling 3.0 multitoma, en inglés). No hacemos afirmaciones sobre diferencias de calidad visual entre versiones: prueba el mismo prompt en ambos modelos y compara.

Precio: por segundo de video generado

kling-v4 se cobra por segundo de video generado, según la resolución solicitada, y el precio es el mismo con o sin audio. Estos son los precios oficiales de la ficha del modelo kling-v4:

Resolución	Precio oficial	Clip de 5 s	Clip de 10 s	Clip de 30 s
720p	$0.1471 / s	≈ $0.74	≈ $1.47	≈ $4.41
1080p	$0.2206 / s	≈ $1.10	≈ $2.21	≈ $6.62

Tu tarifa real depende de los grupos de tu clave y aparece en la Plaza de modelos tras iniciar sesión. Solo se cobra una tarea completada. Al terminar, usage.cost_usd en la respuesta es el importe exacto descontado de tu saldo. Los precios del resto de la familia Kling están en la página de precios.

Paso 1a: texto a video

Todos los modelos de Kling usan el mismo endpoint. Autentícate con tu clave de HopBase como token Bearer:

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v4",
    "prompt": "Travelling lento por una calle de neón bajo la lluvia de noche, reflejos en el asfalto, tráfico a lo lejos",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "21:9"
  }'

• model: kling-v4.
• prompt: obligatorio si no hay imagen, hasta 2,500 caracteres.
• duration: segundos enteros de 3 a 30. Si lo omites, se usan 5.
• resolution: 720p o 1080p; también determina el precio. Si lo omites, se usa 720p.
• aspect_ratio: 16:9, 9:16, 1:1 o 21:9. El gateway no lo completa si falta, así que indícalo siempre en texto a video.
• audio: puedes omitirlo. El resultado siempre lleva sonido y el precio no cambia.

Un envío correcto devuelve 202 con el ID de tarea en id:

{
  "id": "kt57xYOUR_TASK_ID",
  "object": "video.generation.task",
  "model": "kling-v4",
  "status": "queued",
  "created": 1790000000,
  "billing_bucket": "1080p_..."
}

Paso 1b: imagen a video con primer fotograma

Para animar una imagen fija, ponla en images[] con usage: "first_frame":

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v4",
    "prompt": "La cámara se acerca despacio mientras sale vapor de la taza de café",
    "duration": 8,
    "resolution": "720p",
    "images": [
      { "url": "https://cdn.example.com/coffee.png", "usage": "first_frame" }
    ]
  }'

• El resultado sigue la relación de aspecto de la imagen de entrada y aspect_ratio no tiene efecto. Recorta la imagen a 9:16 si quieres un video vertical.
• Cada imagen lleva exactamente uno de url o file_id. La url debe ser una dirección http(s) absoluta y pública; las rutas relativas, file://, IP privadas o de loopback y URL con credenciales se rechazan al enviar.
• usage es obligatorio. kling-v4 solo acepta primer fotograma; una imagen con usage: "reference" devuelve 400 model kling-v4 does not support reference-based generation.

Paso 2: consultar hasta que termine

curl https://api.hop-base.com/v1/video/tasks/kt57xYOUR_TASK_ID \
  -H "Authorization: Bearer sk-YOUR_KEY"

status pasa de queued a processing y termina en completed o failed. Solo esos dos son finales; cualquier otro valor significa que sigue en curso. Una tarea completada:

{
  "id": "kt57xYOUR_TASK_ID",
  "status": "completed",
  "outputs": ["https://api.hop-base.com/..."],
  "usage": { "bucket": "1080p_...", "billed_seconds": 10, "cost": ..., "cost_usd": 2.206, "currency": "CNY" }
}

outputs contiene enlaces firmados en api.hop-base.com válidos durante 24 horas desde que termina la tarea. Volver a consultar devuelve el mismo enlace sin prolongarlo y un enlace caducado devuelve 410, así que descarga el archivo de inmediato. usage.cost_usd es lo descontado de tu saldo en USD; cost es el mismo cargo expresado en CNY. Una tarea fallida también responde con HTTP 200, status: "failed" y un error.code estable.

Ejemplo completo en Python

import time
import requests

API = "https://api.hop-base.com/v1"
HEADERS = {"Authorization": "Bearer sk-YOUR_KEY"}

resp = requests.post(f"{API}/video/generate", headers=HEADERS, json={
    "model": "kling-v4",
    "prompt": "Un barco de papel baja por un arroyo en un bosque soleado, pájaros y agua corriendo",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
})
resp.raise_for_status()
task_id = resp.json()["id"]

while True:
    task = requests.get(f"{API}/video/tasks/{task_id}", headers=HEADERS).json()
    if task["status"] == "completed":
        with requests.get(task["outputs"][0], stream=True) as r:
            r.raise_for_status()
            with open(f"{task_id}.mp4", "wb") as f:
                for chunk in r.iter_content(chunk_size=1 << 20):
                    f.write(chunk)
        print("saved", f"{task_id}.mp4", "charged $", task["usage"]["cost_usd"])
        break
    if task["status"] == "failed":
        err = task.get("error", {})
        raise RuntimeError(f'{err.get("code")}: {err.get("message")}')
    time.sleep(10)

La petición de Kling no tiene campo de webhook, así que el seguimiento se hace consultando. Una tarea que sigue sin terminar 2 horas después de crearse se marca como fallida con timeout y no se cobra. Las tareas no se pueden cancelar.

Errores frecuentes

El cuerpo de la petición se valida de forma estricta. Un error al enviar no crea tarea ni genera cobro:

Qué enviaste	error.message
duration fuera de 3–30	model kling-v4 supports 3 to 30 seconds, got 40
Imagen con usage: "reference"	model kling-v4 does not support reference-based generation
Imagen sin usage	images[0].usage is required for standard Kling video requests
resolution "2k" o "4k"	model "kling-v4" does not support billing bucket "..." for this request
Un campo de la API de OpenAI, como size	request body does not match the JSON contract: json: unknown field "size"
Ni prompt ni imagen	prompt and input media cannot both be empty

Un 402 con code insufficient_balance significa que tu saldo, menos el costo estimado de las tareas en curso y de esta, no alcanza. Kling revisa el material durante la tarea, no al enviarla: una imagen que no se puede descargar o no cumple los requisitos se acepta y falla minutos después con reference_input_invalid; si la moderación rechaza el prompt o la imagen, falla con input_sensitive. Ninguno de estos fallos se cobra. El catálogo completo de errores está en la documentación de la API de video de Kling.

Preguntas frecuentes

¿Cuál es el ID de modelo de Kling 4.0?

kling-v4. Llama a GET /v1/models con tu clave para confirmar que está incluido antes de enviar trabajo de pago.

¿Cuánto puede durar un video de Kling 4.0?

De 3 a 30 segundos por tarea, en segundos enteros. Si omites duration, son 5 segundos.

¿Kling 4.0 admite 2K o 4K?

Todavía no. kling-v4 admite 720p y 1080p. Para 2K o 4K usa kling-v3 o kling-v3-omni.

¿Puedo desactivar el audio?

No. El resultado siempre lleva pista de audio, incluso con audio: false, y el precio es el mismo. Si necesitas un archivo sin sonido, quita la pista después de descargarlo.

¿Admite imágenes de referencia o video de referencia?

No. Solo acepta un prompt de texto y, opcionalmente, una imagen como primer fotograma. Para referencias, sujetos personalizados o multitoma, usa kling-v3-omni o kling-v3.

¿Por qué aspect_ratio no funciona en imagen a video?

Con primer fotograma, el resultado sigue la relación de aspecto de la imagen de entrada y aspect_ratio se ignora. Recorta la imagen antes de enviarla.

¿Cuánto tarda la generación?

Normalmente unos minutos. Consulta cada 5 a 10 segundos. Una tarea sin terminar 2 horas después de crearse falla con timeout y no se cobra.

¿Cuánto cuesta un video de 10 segundos en 1080p?

Al precio oficial, 10 × $0.2206 ≈ $2.21. El cargo real de cada tarea se devuelve en usage.cost_usd y aparece en tu historial de uso.

¿Cómo empiezo?

Crea una clave de API en la consola de HopBase con un grupo que incluya Kling y comprueba que kling-v4 aparece en GET /v1/models. Los demás modelos de video están en la visión general de video. Si además quieres usar Claude, GPT o DeepSeek con esa misma clave, consulta nuestra guía de una sola API key para chat y video.