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. En VocalLab Studio, haz clic en API y MCP en la barra lateral (también puedes usar la página Desarrollador en vocallab.ai).
2. Introduce un nombre para la clave (p. ej., "Production" o "Zapier") y crea la clave.
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 la página API y MCP (o en Desarrollador), haz clic en Revocar 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 (120 en el plan Max).