Introducción a la API

Cómo funciona

La API de kling-4.ai ofrece un conjunto reducido de endpoints REST con una idea central: creas una tarea de generación y consultas su estado hasta que el video esté listo.

POST /api/ai-video/jobs          create a generation job
GET  /api/ai-video/jobs/{id}     fetch one job (refreshes provider status)
GET  /api/ai-video/jobs          list your recent jobs
POST /api/ai-video/jobs/sync     refresh all of your active jobs at once

• URL base: https://kling-4.ai
• Autenticación: una clave de API aprobada en la cabecera x-api-key; consulta Autenticación.
• Formato: JSON de entrada y de salida.
• Modelo: el campo model de la tarea elige el modelo Kling; consulta Modelos. El acceso web a Kling 4.0 no implica acceso API. Este endpoint anterior no acepta kling-v4; usa solo identificadores documentados.

Inicio rápido

1. Consigue una clave. El acceso mediante claves de API se está desplegando durante la v1. Contáctanos si necesitas acceso desde un servidor.

2. Crea una tarea:

curl -X POST 'https://kling-4.ai/api/ai-video/jobs' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "kling-v2-6",
    "prompt": "A cinematic sunrise over a glass city, slow drone push-in",
    "parameters": {
      "mode": "std",
      "duration": 5,
      "aspectRatio": "16:9"
    }
  }'

La respuesta contiene la tarea cuyo estado consultarás:

{
  "job": {
    "id": "0b6c2f6e-6d5f-4a4e-9d3e-7c9a1f2b8d41",
    "model": "kling-v2-6",
    "status": "queued",
    "progress": 0,
    "resultUrl": null,
    "createdAt": "2026-07-09T03:12:45.000Z"
  }
}

3. Consulta hasta que termine:

curl 'https://kling-4.ai/api/ai-video/jobs/0b6c2f6e-6d5f-4a4e-9d3e-7c9a1f2b8d41' \
  -H 'x-api-key: YOUR_API_KEY'

Cuando status pase a completed, la tarea incluirá un resultUrl con el archivo de video y un thumbnailUrl. La generación suele tardar unos minutos; consultar cada 10–15 segundos es suficiente. Los enlaces resultUrl caducan: comprueba resultExpiresAt y descarga el archivo a tiempo.

Encontrarás versiones ejecutables de este flujo en Node.js y Python en nuestro repositorio awesome-kling-4 de GitHub, junto con una biblioteca de prompts probados.

Resumen de endpoints

Cuotas

Los invitados pueden reclamar una recompensa única para probar la creación de imágenes. Para generar vídeos hay que iniciar sesión. Las cuentas que cumplan los requisitos reciben una recompensa de bienvenida en lugar de la recompensa diaria de ese día; en fechas UTC posteriores reciben la recompensa diaria. Cada generación debe respetar el coste calculado por el servidor y los límites de coste gratuito aplicables. Las claves aprobadas usan los créditos o la cuota asignados a su espacio de trabajo. Consulta Errores para ver las respuestas por créditos insuficientes y fallos de validación; si necesitas más volumen, contáctanos.