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. Cuando se lance una nueva generación de Kling, tu integración cambia ese campo.

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 del navegador pueden reclamar créditos gratuitos una vez por fecha UTC en la que cumplan los requisitos. Cada configuración compatible muestra su coste y solo se acepta la solicitud si el saldo cubre el presupuesto definitivo del servidor. 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.