Démarrage rapide

RouteAPI fournit un point d’entrée authentifié pour les API compatibles OpenAI, Claude Messages et Google Gemini. Ce guide vous accompagne de la création du compte jusqu’à la vérification d’une requête, puis vous aide à choisir la bonne méthode d’intégration.

Avant de commencer

Préparez un compte RouteAPI, un token créé dans la console et un identifiant de modèle autorisé pour ce token. Conservez le token côté serveur ou dans une variable d’environnement, jamais dans le navigateur ou un dépôt public.

Trois étapes pour commencer

1. Créer un compte. Ouvrez la console RouteAPI et inscrivez-vous par e-mail ou avec Google. Le tableau de bord affiche le solde, l’utilisation et l’état du compte.
2. Créer un token. Ouvrez Gestion des tokens → Créer une clé, indiquez un nom et une date d’expiration, puis ajoutez si nécessaire des limites de quota ou de modèles.
3. Tester une requête. Définissez ROUTEAPI_KEY, choisissez un modèle disponible et exécutez l’exemple cURL ci-dessous.

Utilisez l'identifiant du modèle

La disponibilité dépend du token. Consultez la liste des modèles et utilisez la valeur id, pas le nom affiché dans la console.

Envoyer une requête

L’endpoint compatible OpenAI est le moyen le plus court de vérifier l’intégration :

export ROUTEAPI_KEY="sk-your-routeapi-token"

curl https://api.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "Bonjour RouteAPI"}]
  }'

La réponse contient le message et l’utilisation. Conservez l’identifiant de requête renvoyé par l’API ou le client lorsqu’il est disponible pour faciliter le diagnostic. Si gpt-5.5 n’est pas disponible, utilisez un ID renvoyé par GET /v1/models.

Choisir une méthode d’intégration

API directe Utilisez cURL ou n'importe quel client HTTP, sans dépendance supplémentaire.

SDK compatible OpenAI Conservez votre code OpenAI et remplacez seulement la clé et la Base URL.

Outils développeur Configurez Codex, Cursor, Claude Code, OpenCode, LangChain ou LiteLLM.

Node.js et Python

RouteAPI est compatible avec les SDK OpenAI officiels. Choisissez votre runtime, puis installez le SDK correspondant :

bun add openai
pip install openai

import OpenAI from 'openai';
const client = new OpenAI({
  apiKey: process.env.ROUTEAPI_KEY,
  baseURL: 'https://api.routeapi.ai/v1',
});
const response = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: 'Présentez RouteAPI en une phrase' }],
});
console.log(response.choices[0].message.content);

Consultez les exemples Node.js, Python et OpenAI SDK.

Recevoir une réponse en flux

Ajoutez "stream": true pour recevoir les événements SSE au fur et à mesure. Lisez les lignes data: et arrêtez-vous à data: [DONE].

curl https://api.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","stream":true,"messages":[{"role":"user","content":"Expliquez RouteAPI en trois points"}]}'

La prise en charge du streaming et de l’usage final dépend du modèle. Consultez Réponses en streaming.

Vérifier et dépanner

curl https://api.routeapi.ai/v1/models -H "Authorization: Bearer $ROUTEAPI_KEY"

• 401 : vérifiez le token et l’en-tête Authorization.
• 402 : vérifiez le solde ou le quota du token.
• 429 : réduisez la fréquence des appels.
• 502/503 : vérifiez le service du modèle et limitez les nouvelles tentatives.
• Modèle indisponible : vérifiez l’ID exact et ses capacités.

Pour aller plus loin, consultez Débogage des requêtes et Erreurs courantes. Les journaux de la console contiennent le statut, la latence, les tokens, le coût et les détails d’erreur.

Étapes suivantes

Vue d'ensemble de l'API Protocoles, Base URL, en-têtes et limites de compatibilité.

Modèles et tarifs IDs, capacités, disponibilité et tarifs actuels.

Routage et reprise Comprendre les chemins de service et la protection contre les pannes.

En production, gardez les tokens côté serveur, fixez les IDs de modèles, enregistrez les IDs de requête et testez les fonctions optionnelles avec le modèle réellement utilisé.