Chiavi API

Le chiavi API autenticano le tue richieste all'API di VocalLab. L'accesso all'API richiede il piano Pro o superiore.

Creare una chiave

1. In VocalLab Studio, clicca su API e MCP nella barra laterale (puoi anche usare la pagina Developer su vocallab.ai).
2. Inserisci un nome per la chiave (es. "Produzione" o "Zapier") e crea la chiave.
3. Copia la chiave immediatamente — inizia con vl_live_ e viene mostrata una sola volta. Memorizziamo solo una versione con hash e non possiamo mostrarla di nuovo.

Usare una chiave

Inviala come token Bearer in ogni richiesta:

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

Revocare una chiave

Nella pagina API e MCP (o in Developer), fai clic su Revoke accanto a una chiave. Smette di funzionare immediatamente. Se una chiave viene mai compromessa, revocala e creane una nuova.

Buone pratiche

• Conserva le chiavi in variabili d'ambiente o in un gestore di segreti — mai nel codice o in git.
• Usa una chiave separata per ogni app o integrazione, così puoi revocarne una senza compromettere le altre.
• Se il tuo piano scende sotto Pro, le chiavi smettono di funzionare finché non torni almeno a Pro (non vengono eliminate).

Limiti

• Fino a 5 chiavi attive per account.
• 60 richieste al minuto per chiave (120 con il piano Max).