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. Klicke in VocalLab Studio in der Seitenleiste auf API & MCP (du kannst auch die Seite Entwickler auf vocallab.ai nutzen).
2. Gib einen Schlüsselnamen ein (z. B. "Production" oder "Zapier") und erstelle den Schlüssel.
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 auf der Seite API & MCP (oder Entwickler) 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 (120 im Max-Tarif).