API Keys

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

Create a key

1. Go to Developer settings.
2. Enter a name (e.g. "Production" or "Zapier") and click Create 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 Developer settings, 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.