Connecter les apps et les agents de code

Utilisez une clé API Route Key et une passerelle compatible pour vos applications, SDK et outils de code.

Create API key Explorer les modeles
Étape 01

Connecter votre application IA

Trois valeurs suffisent pour envoyer votre première requête compatible.

  • Base URLhttps://api.routekey.ai/v1
  • AutorisationBearer YOUR_ROUTEKEY_API_KEY
  • ModèleChoisissez un ID activé exact dans Modèles.
Première requête fonctionnelle
curl https://api.routekey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_ROUTEKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<route-key-model>","messages":[{"role":"user","content":"Hello"}]}'
Étape 02

Configurer un agent de code

Utilisez une clé dédiée par outil et copiez le profil correspondant.

Install CodexDocs officielles
npm install -g @openai/codex
~/.codex/config.toml
model = "<route-key-coding-model>"
model_provider = "routekey"

[model_providers.routekey]
name = "Route Key"
base_url = "https://api.routekey.ai/v1"
env_key = "ROUTEKEY_API_KEY"
  • Créez une clé API Route Key dédiée.
  • Choisissez un modèle activé dans Modèles.
  • Redémarrez l’outil et vérifiez les journaux.
Checklist opérationnelle

Garder chaque intégration maintenable

La compatibilité OpenAI réduit la migration, mais une intégration fiable demande une clé par outil, un modèle testé et une base URL en configuration. Modeles.

Lire la documentation développeur Comparer les modèles pris en charge
Préparer une connexion API sûre et reproductible

Créer et protéger votre clé API

Créez une clé depuis le Dashboard, nommez-la clairement et utilisez une clé par application ou outil. Conservez-la dans une variable secrète et ne la publiez jamais dans le code ou les journaux.

Comprendre les trois valeurs de la requête

La base URL sélectionne la passerelle, le jeton Bearer authentifie la requête et l'ID du modèle sélectionne un modèle activé. Utilisez l'ID exact de la page Modèles. Modeles.

Confirmer l’accès avant le déploiement

Vérifiez le solde ou le quota, le groupe du modèle et la compatibilité de l’endpoint. Une courte requête non streamée isole rapidement les erreurs.

Confirmer la réponse et consulter les journaux
  1. Envoyez une courte requête avec une petite limite de sortie et vérifiez la réponse ou le flux.
  2. Notez l’ID du modèle et l’endpoint qui ont répondu afin de reproduire la configuration.
  3. Ouvrez les journaux et vérifiez la requête, les tokens, la latence et le coût.
  4. Ajoutez progressivement le streaming, les outils, le contexte long et la concurrence.

Erreurs d’authentification 401 ou 403

Vérifiez le préfixe Authorization: Bearer, les espaces, l’état de la clé et la base URL /v1.

Modèle introuvable ou indisponible

Copiez l’ID activé depuis Modèles et confirmez son groupe et son endpoint.

Erreurs de quota, solde ou débit

Vérifiez le portefeuille, les limites et les journaux. Réduisez la concurrence ou la sortie pour le test.

Puis-je utiliser un SDK OpenAI existant ?

Généralement oui. Conservez le format du SDK, définissez la base URL Route Key /v1 et utilisez une clé API Route Key.

Faut-il partager une clé entre plusieurs outils ?

Non. Une clé par application ou agent facilite les journaux et la rotation sans interrompre les autres intégrations.

Où analyser une différence de coût ?

Comparez le modèle, le ratio de groupe, les tokens, l’endpoint et l’heure dans les journaux, puis consultez le catalogue de prix.