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 peticiones sin clave siguen funcionando en el navegador: así atiende el generador gratuito a los invitados, mediante una cookie. Sin embargo, usa siempre una clave de API para integraciones de servidor; la identidad de invitado depende de las cookies y no se conserva 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.