Vue d’ensemble de l’API
OfoxAI propose trois protocoles d’accès API, entièrement compatibles avec les SDKs officiels de chaque fournisseur.
Base URL
| Protocole | Base URL | Description |
|---|---|---|
| Compatible OpenAI | https://api.ofox.ai/v1 | Compatible avec le SDK OpenAI, prend en charge tous les modèles |
| Natif Anthropic | https://api.ofox.ai/anthropic | Compatible avec le SDK Anthropic, expérience native Claude |
| Natif Gemini | https://api.ofox.ai/gemini | Compatible avec le SDK Google GenAI |
Authentification
Tous les protocoles utilisent une clé API OfoxAI unifiée, mais le format du Header varie selon le protocole :
| Protocole | Header | Format |
|---|---|---|
| OpenAI | Authorization | Bearer sk-xxx |
| Anthropic | x-api-key | sk-xxx |
| Gemini | x-goog-api-key | sk-xxx |
Consultez le guide d’authentification pour plus de détails.
Endpoints disponibles
Protocole compatible OpenAI
| Endpoint | Méthode | Description |
|---|---|---|
/v1/chat/completions | POST | Créer une complétion de chat |
/v1/embeddings | POST | Créer des embeddings de texte |
/v1/models | GET | Lister les modèles disponibles |
/v1/models/{model_id} | GET | Obtenir les détails d’un modèle |
/v1/images/generations | POST | Génération d’images |
Protocole natif Anthropic
| Endpoint | Méthode | Description |
|---|---|---|
/anthropic/v1/messages | POST | Créer des Messages |
Protocole natif Gemini
| Endpoint | Méthode | Description |
|---|---|---|
/gemini/v1beta/models/{model}:generateContent | POST | Générer du contenu |
/gemini/v1beta/models/{model}:streamGenerateContent | POST | Générer du contenu en streaming |
Limites de débit
OfoxAI fonctionne en paiement à l’usage. Tous les utilisateurs partagent la même politique de débit, sans distinction de forfait :
| Limite | Quota |
|---|---|
| RPM (requêtes/minute) | 200 |
| TPM (tokens/minute) | Illimité |
Si vous avez besoin d’un quota de débit plus élevé, contactez le support OfoxAI pour demander un ajustement.
Lorsque la limite de débit est atteinte, l’API retourne 429 Too Many Requests avec les Headers de réponse suivants :
x-ratelimit-limit-requests: 200
x-ratelimit-remaining-requests: 0
x-ratelimit-reset-requests: 1sCodes d’erreur
Tous les protocoles retournent des codes de statut HTTP unifiés :
| Code | Description | Cause fréquente |
|---|---|---|
200 | Succès | — |
400 | Erreur de requête | Format de paramètres incorrect, champs obligatoires manquants |
401 | Échec d’authentification | Clé API invalide ou expirée |
403 | Permissions insuffisantes | Le compte n’a pas accès à ce modèle |
404 | Ressource introuvable | ID de modèle incorrect |
429 | Limite de débit atteinte | Dépassement de la limite de débit |
500 | Erreur serveur | Erreur interne, veuillez réessayer |
502 | Erreur en amont | Service du fournisseur de modèles en panne |
503 | Service indisponible | Service en maintenance |
Format de réponse d’erreur
{
"error": {
"code": "invalid_api_key",
"message": "La clé API fournie n'est pas valide. Veuillez la vérifier et réessayer.",
"type": "authentication_error"
}
}Paramètres étendus OfoxAI
OfoxAI propose des paramètres étendus au-delà des protocoles standard pour le contrôle avancé du routage et du repli :
{
"model": "openai/gpt-4o",
"messages": [...],
"provider": {
"routing": "cost",
"fallback": ["anthropic/claude-sonnet-4.5", "google/gemini-3-flash-preview"]
}
}Consultez routage des fournisseurs et repli automatique pour plus de détails.