Claves de API

Las claves de API autentican tus solicitudes a la API de VocalLab. El acceso a la API requiere el plan Pro o superior.

Crear una clave

1. Ve a Ajustes de desarrollador.
2. Introduce un nombre (p. ej., "Production" o "Zapier") y haz clic en Create key.
3. Copia la clave de inmediato: empieza por vl_live_ y se muestra una sola vez. Solo guardamos una versión cifrada (hash) y no podemos volver a mostrarla.

Usar una clave

Envíala como token Bearer en cada solicitud:

curl https://api.vocallab.ai/api/v1/ping \
  -H "Authorization: Bearer vl_live_..."

Revocar una clave

En Ajustes de desarrollador, haz clic en Revoke junto a una clave. Deja de funcionar de inmediato. Si alguna vez se filtra una clave, revócala y crea una nueva.

Buenas prácticas

• Guarda las claves en variables de entorno o en un gestor de secretos, nunca en el código ni en git.
• Usa una clave distinta por aplicación o integración, así puedes revocar una sin afectar a las demás.
• Si tu plan baja de Pro, las claves dejan de funcionar hasta que vuelvas a Pro o superior (no se eliminan).

Límites

• Hasta 5 claves activas por cuenta.
• 60 solicitudes por minuto por clave.