API Keys

API keys authenticate your requests to the VocalLab API. API access requires a Pro plan or higher.

Create a key

1. In VocalLab Studio, click API & MCP in the sidebar (you can also use the Developer page on vocallab.ai).
2. Enter a key name (e.g. "Production" or "Zapier") and create the key.
3. Copy the key immediately — it starts with vl_live_ and is shown only once. We store only a hashed version and cannot show it again.

Use a key

Send it as a Bearer token on every request:

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

Revoke a key

On the API & MCP page (or Developer), click Revoke next to a key. It stops working immediately. If a key is ever leaked, revoke it and create a new one.

Good practice

• Store keys in environment variables or a secrets manager — never in code or git.
• Use a separate key per app or integration, so you can revoke one without affecting the others.
• If your plan drops below Pro, keys stop working until you're back on Pro or higher (they aren't deleted).

Limits

• Up to 5 active keys per account.
• 60 requests per minute per key (120 on the Max plan).