Autenticación
Solicita acceso a la API y autentica tus peticiones con la cabecera x-api-key.
Obtén una clave de API
El acceso mediante claves de API se está desplegando durante la v1. El generador web usa créditos gratuitos reclamados expresamente y muestra el coste antes de enviar la solicitud. Para acceder desde un servidor, contáctanos con tu caso de uso y el volumen previsto.
Cuando recibas una clave, guárdala de forma segura. Trátala como una contraseña: no la pegues en código frontend, repositorios públicos, capturas compartidas ni herramientas de análisis.
Usa la clave
Inclúyela en la cabecera x-api-key de cada petición:
curl 'https://kling-4.ai/api/ai-video/jobs' \
-H 'x-api-key: YOUR_API_KEY'const res = await fetch('https://kling-4.ai/api/ai-video/jobs', {
headers: { 'x-api-key': process.env.KLING_API_KEY! },
});
const { jobs } = await res.json();Una petición autenticada con una clave válida actúa en nombre de tu espacio de trabajo aprobado. Las tareas que crea pertenecen a esa clave y consumen la cuota que tiene asignada.
Las sesiones del navegador pueden usar cookies en lugar de una clave de API. Los invitados pueden probar la creación de imágenes; las nuevas solicitudes de vídeo requieren una cuenta con sesión iniciada. Usa siempre una clave de API para integraciones de servidor, porque las sesiones del navegador no se conservan entre máquinas.
Mantén la clave en secreto
- Llama a la API desde tu servidor, nunca desde el navegador: cualquiera que lea el código frontend podría extraer la clave.
- Guarda la clave en una variable de entorno (
KLING_API_KEY), no en el control de versiones. - Si sospechas que una clave se ha expuesto, contáctanos para que podamos sustituirla.
Introducción a la API
API pública anterior de vídeo: modelos documentados, tareas asíncronas y resultados. El acceso web a Kling 4.0 es independiente.
Generar un video
POST /api/ai-video/jobs: crea una tarea a partir de un prompt de texto, con imágenes de referencia, audio y control del fotograma final opcionales.