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

OfoxAI OpenAPI (Compte)

Endpoints de plateforme indépendants du protocole, authentifiés avec la clé API OfoxAI.

Endpoint	Méthode	Description
`/v1/user/balance`	GET	Consultation du solde, compatible avec cc-switch

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)	100 (agrégé par équipe)
TPM (tokens/minute)	Illimité

Le RPM est agrégé au niveau de l’équipe : plusieurs clés API d’une même équipe partagent un quota unique. Si vous avez besoin d’un quota RPM plus élevé, contactez [email protected] 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: 100
x-ratelimit-remaining-requests: 0
x-ratelimit-reset-requests: 1s

Codes 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.6", "google/gemini-3.1-flash-lite-preview"]
  }
}

Consultez routage des fournisseurs et repli automatique pour plus de détails.