Documentation API IA compatible OpenAI

Intégrez plusieurs modèles IA via une passerelle avec vos SDK, une Base URL et une API Key.

Ouvrir le tutoriel

Référence API

Après un premier appel réussi, consultez cette section pour les paramètres de requête et formats de réponse propres à chaque fournisseur.

30 Points d'accès API des modèles
POSTOpenAIOpenAI/chat/completions

Créer une complétion de chat

Crée une réponse de modèle à partir de l'historique de conversation, avec streaming, outils et comptabilisation de l'utilisation.

Authentification

Utilisez votre clé API avec Authorization: Bearer sk-xxxx.

Authorization: Bearer sk-xxxx
Type de contenu
application/json
Exemples de modèles
gpt-4o, gpt-4.1, gpt-5, o3, o4-mini

Exemple de requête

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}

Exemple de réponse

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "created": 0,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello!"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 3,
    "total_tokens": 11
  }
}

Exemple curl

curl -X POST 'https://costrouter.ai/v1/chat/completions' \
  -H 'Authorization: Bearer sk-xxxx'
  -H 'Content-Type: application/json'
  -d '{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}'
Paramètres
NomTypeObligatoireDescription
modelstringOuiID du modèle. CostRouter l'utilise pour identifier les routes compatibles et disponibles pour la requête.
messagesarray<object>OuiTableau de messages de conversation, généralement avec les rôles system, user, assistant ou tool.
temperaturenumberNonTempérature d'échantillonnage. Des valeurs plus élevées rendent la sortie plus aléatoire.
top_pnumberNonParamètre d'échantillonnage nucleus, généralement ajusté à la place de temperature.
streambooleanNonIndique s'il faut retourner une réponse en streaming.
max_tokensintegerNonNombre maximal de tokens de sortie.
toolsarray<object>NonDéfinitions d'outils ou de fonctions. La prise en charge dépend du modèle sélectionné.
response_formatobjectNonFormat de réponse structurée. La prise en charge dépend du modèle sélectionné.
Exemple de réponse
NomTypeObligatoireDescription
idstringNonID de réponse, de tâche ou de ressource.
objectstringNonType d'objet de réponse.
createdintegerNonHorodatage de création.
modelstringNon-
choicesarray<object>NonSorties candidates du modèle.
usageobjectNonStatistiques d'utilisation des tokens.

Erreurs courantes et corrections

Les échecs du premier appel sont généralement liés à l'authentification, à l'ID du modèle, au solde ou à la limite de dépenses, ou aux paramètres de la requête.

401

Échec d'authentification

Vérifiez que Authorization utilise Bearer suivi de votre clé API CostRouter.

403

Problème d'accès ou de solde

Vérifiez l'état de la clé, le solde, l'accès au modèle et la facturation.

429

Limite de débit atteinte

Réduisez le nombre de requêtes simultanées, réessayez avec un backoff ou vérifiez les limites du compte.

5xx

Échec du fournisseur ou du routage

Réessayez plus tard et consultez les journaux d'utilisation pour vérifier le statut de la requête et la route du modèle.

Copyright 2026 CostRouter. Tous droits réservés.

CostRouter est interdit aux utilisateurs situés en Chine continentale. Si une utilisation depuis la Chine continentale est constatée, CostRouter peut suspendre ou fermer le compte, sans remboursement des frais payés ni du solde restant.

Nous contacter

Choisissez le canal le plus adapté à votre demande.

Nous contacter
Documentation API compatible OpenAI | CostRouter