Authentifizierung

OneProvider akzeptiert sowohl Bearer im OpenAI-Stil als auch x-api-key im Anthropic-Stil. Senden Sie eines von beiden, nie beide.

Header-Formen

Die API akzeptiert beide Header. Nutzen Sie den, den Ihr SDK ohnehin sendet.

Authorization: Bearer sk-... # OpenAI-style
x-api-key: sk-... # Anthropic-style

Umgebungsvariablen

In unseren Beispielen steht der Schlüssel in ONEPROVIDER_KEY. SDK-Clients lesen standardmäßig jedoch automatisch ihre eigenen Variablennamen – exportieren Sie den Schlüssel also unter diesem Namen oder übergeben Sie ONEPROVIDER_KEY ausdrücklich an den Konstruktor. Die Tabelle unten zeigt, was welches Tool liest:

Authentifizierung prüfen

Rufen Sie /v1/models für eine günstige Prüfung ohne Nebenwirkungen auf:

curl -s https://api.oneprovider.dev/v1/models \
-H "x-api-key: $ONEPROVIDER_KEY" | jq '.data[].id'

Eine erfolgreiche Antwort listet die aktuellen Modelle auf. Ein 401 bedeutet hier: Der Schlüssel ist fehlerhaft, widerrufen oder noch nicht aktiv.

Wo Sie den Schlüssel aufbewahren

• Umgebungsvariablen – der Standard für die meisten Fälle.
• ~/.zshrc / ~/.bashrc mit gesetztem HISTCONTROL=ignorespace, damit Befehle mit führendem Leerzeichen nicht in der Shell-History landen.
• Secret-Manager: 1Password CLI, AWS Secrets Manager, Doppler, GCP Secret Manager.
• .env-Dateien pro Projekt – immer in .gitignore eintragen.

Häufige Stolperfallen

• Schrägstrich am Ende. https://api.oneprovider.dev/v1/ oder https://api.oneprovider.dev/v1 – manche SDKs hängen den Pfad naiv an. Verwenden Sie die Form ohne Schrägstrich am Ende wie oben.
• Doppeltes Bearer. Authorization: Bearer Bearer sk-... entsteht, wenn ein Tool Bearer schon voranstellt und Sie es noch einmal ergänzen. Entfernen Sie das Präfix in Ihrer Konfiguration.
• Anthropic-Versions-Header. Senden Sie bei rohen HTTP-Aufrufen immer anthropic-version: 2023-06-01 mit. SDKs ergänzen ihn automatisch.

Schlüssel rotieren

Stellen Sie im Konto einen neuen Schlüssel aus („Schlüssel“ → „Schlüssel ausstellen“), tragen Sie ihn in Ihren Clients ein und löschen Sie dann den alten. Das geht sofort und kostenlos, und das Guthaben teilen sich alle Schlüssel des Kontos. Mehr: Konto & Schlüssel .

Kurze Antworten

Welche base URL verwende ich?

Claude Code und die Anthropic-SDKs verwenden https://api.oneprovider.dev. OpenAI-SDKs und OpenAI-kompatible Clients verwenden https://api.oneprovider.dev/v1. Ein Schlüssel funktioniert an beiden Adressen; die Modellliste finden Sie auf der Modellseite , die Preise auf der Preisseite .

Wie authentifiziere ich mich?

Senden Sie den unveränderten sk-…-Schlüssel in x-api-key oder Authorization: Bearer: nur eines von beiden, nie beide. Bewahren Sie den Schlüssel in einer Umgebungsvariable auf, nicht in einer Datei, die ins Repository committet wird. Mehr zur Authentifizierung .

Wo bekomme ich einen Schlüssel?

Öffnen Sie Ihr Konto im Telegram-Bot @oneprovider_robot oder auf app.oneprovider.dev, laden Sie das Guthaben auf und tippen Sie auf „Schlüssel ausstellen“. Jeder Schlüssel kann ein eigenes Ausgabenlimit haben. Konto & API-Schlüssel .

Was bedeuten 401, 404 und 429?

401: Der Schlüssel fehlt, ist falsch geschrieben oder steht im falschen Header; fügen Sie den ganzen Schlüssel ohne Anführungszeichen und Leerzeichen ein. 404: meist eine falsche base URL, zum Beispiel ein fehlendes oder doppeltes /v1. 429 mit „Insufficient balance“: Das Guthaben des Kontos oder das Ausgabenlimit des Schlüssels ist aufgebraucht – laden Sie auf, statt es erneut zu versuchen; jedes andere 429 ist ein Rate-Limit, warten Sie dann die Zeit aus Retry-After ab. Details: Fehlercodes und Fehlerbehebung .

Warum brechen Streams ab oder werden zurückgesetzt?

VPN- und VLESS-Proxys puffern SSE oft oder stören die HTTP/2-Aushandlung. OneProvider hat keine regionalen Beschränkungen und puffert keine Streams – schalten Sie den Proxy aus und versuchen Sie es erneut.

Wohin wende ich mich, wenn das nicht reicht?

Schreiben Sie @Oneproviderhelpbot auf Telegram oder öffnen Sie „Support“ im Web-Konto – mit HTTP-Statuscode und genauer Fehlermeldung. So arbeitet der Support .