Authentifizierung

Sichere jede Anfrage mit einem Inhabertoken mit deinem EmpirioLabs-API-Schlüssel

Alle API-Anfragen von EmpirioLabs müssen ein Inhabertoken im Authorization-Header enthalten.

API-Schlüsselformat

API-Schlüssel verwenden das Präfix sk-empiriolabs-. Du kannst bis zu 50 API-Schlüssel pro Konto aus dem Dashboard generieren.

1Authorization: Bearer sk-empiriolabs-...

Header-Format

Fügen Sie bei jeder Anfrage den Header hinzu:

$curl "https://api.empiriolabs.ai/v1/models" \
> -H "Authorization: Bearer sk-empiriolabs-your_key_here"

Tarifbegrenzungen

Jedes Konto beginnt mit Default Rate Limits:

GrenzeDefault
Anfragen pro Minute50 U/min
Token pro Minute2.000.000 TPM

Wenn Sie höhere Limits benötigen, schreiben Sie eine E-Mail an support@empiriolabs.ai. Siehe Limits and API Keys für alle Details.

Empfohlene Praktiken

  • Generiere separate API-Schlüssel für Produktion, Staging und Entwicklung
  • Rotieren Sie die Tasten regelmäßig und unmittelbar nach vermuteter Exposition
  • Speichern Sie Schlüssel in einem Secret Manager oder einer Bereitstellungsplattform – niemals im clientseitigen Code, öffentlichen Speichern oder Protokollen
  • Lösche ungenutzte Schlüssel umgehend aus dem Dashboard

Teste deine Qualifikationen

Eine schnelle Möglichkeit, zu überprüfen, ob Ihr Schlüssel funktioniert:

$curl "https://api.empiriolabs.ai/v1/models" \
> -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Eine 200 Antwort mit dem Modellkatalog bestätigt, dass dein Schlüssel gültig ist und dein Konto korrekt eingerichtet wurde.

Häufige Authentifizierungsantworten

StatuscodeBedeutungWas zu tun ist
401 UnauthorizedDas Token fehlt, ist missgestaltet oder nicht gefundenÜberprüfe das Authorization: Bearer sk-empiriolabs-... Header-Format und ob der Schlüssel in deinem Dashboard existiert
402 Payment RequiredDas Konto hat nicht genügend GuthabenLaden Sie die Credits auf der Dashboard-Abrechnungsseite auf
429 Too Many RequestsGeschwindigkeitslimit überschritten (50 U/min Standard)Versuchen Sie es erneut mit exponentiellem Backoff und überprüfen Sie Ihr Anfragevolumen