API-Schlüssel

API-Schlüssel authentifizieren deine Anfragen an die VocalLab API. Der API-Zugriff erfordert mindestens den Pro-Plan.

Einen Schlüssel erstellen

1. Gehe zu den Entwicklereinstellungen.
2. Gib einen Namen ein (z. B. "Production" oder "Zapier") und klicke auf Schlüssel erstellen.
3. Kopiere den Schlüssel sofort — er beginnt mit vl_live_ und wird nur einmal angezeigt. Wir speichern nur eine gehashte Version und können ihn nicht erneut anzeigen.

Einen Schlüssel verwenden

Sende ihn bei jeder Anfrage als Bearer-Token:

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

Einen Schlüssel widerrufen

Klicke in den Entwicklereinstellungen neben einem Schlüssel auf Widerrufen. Er funktioniert sofort nicht mehr. Falls ein Schlüssel jemals geleakt wird, widerrufe ihn und erstelle einen neuen.

Bewährte Vorgehensweise

• Speichere Schlüssel in Umgebungsvariablen oder einem Secrets-Manager — niemals im Code oder in git.
• Verwende für jede App oder Integration einen eigenen Schlüssel, damit du einen widerrufen kannst, ohne die anderen zu beeinträchtigen.
• Wenn dein Plan unter Pro fällt, funktionieren die Schlüssel nicht mehr, bis du wieder mindestens Pro hast (sie werden nicht gelöscht).

Limits

• Bis zu 5 aktive Schlüssel pro Konto.
• 60 Anfragen pro Minute pro Schlüssel.