API-Übersicht
OfoxAI bietet drei API-Protokolle, die vollständig mit den offiziellen SDKs der jeweiligen Anbieter kompatibel sind.
Base URL
| Protokoll | Base URL | Beschreibung |
|---|---|---|
| OpenAI-kompatibel | https://api.ofox.ai/v1 | Kompatibel mit dem OpenAI SDK, unterstützt alle Modelle |
| Anthropic nativ | https://api.ofox.ai/anthropic | Kompatibel mit dem Anthropic SDK, natives Claude-Erlebnis |
| Gemini nativ | https://api.ofox.ai/gemini | Kompatibel mit dem Google GenAI SDK |
Authentifizierung
Alle Protokolle verwenden einen einheitlichen OfoxAI API Key, wobei das Header-Format je nach Protokoll variiert:
| Protokoll | Header | Format |
|---|---|---|
| OpenAI | Authorization | Bearer sk-xxx |
| Anthropic | x-api-key | sk-xxx |
| Gemini | x-goog-api-key | sk-xxx |
Details finden Sie im Authentifizierungsleitfaden.
Verfügbare Endpunkte
OpenAI-kompatibles Protokoll
| Endpunkt | Methode | Beschreibung |
|---|---|---|
/v1/chat/completions | POST | Chat-Vervollständigung erstellen |
/v1/embeddings | POST | Text-Embeddings erstellen |
/v1/models | GET | Verfügbare Modelle auflisten |
/v1/models/{model_id} | GET | Modelldetails abrufen |
/v1/images/generations | POST | Bildgenerierung |
Anthropic natives Protokoll
| Endpunkt | Methode | Beschreibung |
|---|---|---|
/anthropic/v1/messages | POST | Messages erstellen |
Gemini natives Protokoll
| Endpunkt | Methode | Beschreibung |
|---|---|---|
/gemini/v1beta/models/{model}:generateContent | POST | Inhalte generieren |
/gemini/v1beta/models/{model}:streamGenerateContent | POST | Streaming-Inhaltsgenerierung |
Ratenbegrenzung
OfoxAI rechnet nutzungsbasiert ab. Alle Benutzer teilen sich eine einheitliche Ratenbegrenzung ohne Tarifunterschiede:
| Limit | Kontingent |
|---|---|
| RPM (Anfragen/Minute) | 200 |
| TPM (Token/Minute) | Unbegrenzt |
Wenn Sie ein höheres Ratenlimit benötigen, kontaktieren Sie den OfoxAI-Support zur Anpassung.
Bei Erreichen des Ratenlimits gibt die API 429 Too Many Requests zurück. Der Response-Header enthält:
x-ratelimit-limit-requests: 200
x-ratelimit-remaining-requests: 0
x-ratelimit-reset-requests: 1sFehlercodes
Alle Protokolle verwenden einheitliche HTTP-Statuscodes:
| Statuscode | Beschreibung | Häufige Ursachen |
|---|---|---|
200 | Erfolg | — |
400 | Fehlerhafte Anfrage | Ungültiges Parameterformat, fehlende Pflichtfelder |
401 | Authentifizierung fehlgeschlagen | Ungültiger oder abgelaufener API Key |
403 | Keine Berechtigung | Kein Zugriff auf dieses Modell |
404 | Ressource nicht gefunden | Falsche Modell-ID |
429 | Ratenlimit erreicht | Ratenbegrenzung überschritten |
500 | Serverfehler | Interner Fehler, bitte erneut versuchen |
502 | Upstream-Fehler | Fehler beim Modellanbieter |
503 | Dienst nicht verfügbar | Wartungsarbeiten |
Fehlerantwort-Format
{
"error": {
"code": "invalid_api_key",
"message": "Der angegebene API Key ist ungültig. Bitte überprüfen Sie ihn und versuchen Sie es erneut.",
"type": "authentication_error"
}
}OfoxAI-Erweiterungsparameter
OfoxAI bietet zusätzliche Parameter für erweitertes Routing und Failover-Steuerung:
{
"model": "openai/gpt-4o",
"messages": [...],
"provider": {
"routing": "cost",
"fallback": ["anthropic/claude-sonnet-4.5", "google/gemini-3-flash-preview"]
}
}Details finden Sie unter Anbieter-Routing und Failover.