Skip to main content
Erstelle einen Schlüssel im Dashboard, speichere ihn auf deinem Server und sende ihn als Bearer-Token mit Gateway-Anfragen.

Schlüsseltypen

  • Gateway-API-Schlüssel rufen Modell-, Anbieter- und Generierungsendpunkte auf, die für deinen Workspace verfügbar sind.
  • Management-API-Schlüssel rufen Verwaltungs-APIs auf. Siehe Management-API-Schlüssel.
Rotiere einen Schlüssel, indem du deine Anwendung vor dem Ungültigmachen der alten Zugangsdaten auf den Ersatzschlüssel umstellst. Siehe den Endpunkt zur Schlüsselrotation. Schlüssel haben das Format phaseo_v1_sk_<kid>_<secret>. Behandle sie wie Passwörter und speichere sie weder im clientseitigen Code noch in öffentlichen Repositories.
Du kannst :free-Modelle ohne eingezahltes Guthaben aufrufen. Kostenpflichtige Modelle erfordern verfügbares Wallet-Guthaben.

Header-Format

Füge den Schlüssel bei jeder Anfrage in den Authorization-Header ein:
Die meisten HTTP-Clients erlauben es, den Header einmalig festzulegen. Zum Beispiel mit fetch:

Checkliste für den Umgang mit Schlüsseln


Häufige Authentifizierungsfehler

  • 401 Nicht autorisiert: Der Schlüssel fehlt, ist ungültig oder gehört zu einem deaktivierten Workspace.
  • 403 Verboten: Der Schlüssel ist vorhanden, kann aber nicht auf den angeforderten Anbieter oder das Modell zugreifen.
  • 429 Too Many Requests: Der Schlüssel oder Workspace hat ein Limit überschritten. Siehe Anfragelimits.
  • 5xx-Fehler: Versuche es mit exponentiellem Backoff erneut und wende dich an den Support, falls das Problem weiterhin besteht.
Zuletzt geändert am 2. Oktober 2026