Passerelle API IA
Un jeton pour Claude, GPT, Gemini et Qwen, pleinement compatible avec les SDK officiels des fournisseurs. La migration se résume généralement à modifier deux lignes : base_url et api_key.
- Compatibilité des protocoles : appelez directement les protocoles natifs OpenAI, Anthropic et Gemini, sans réécriture
- Streaming : SSE complet avec latence du premier jeton comparable à l'accès direct
- Catalogue : modèles disponibles avec fenêtres de contexte et capacités (vision / outils / raisonnement)
- Utilisation et facturation : facturation par jeton et détail par clé
Une passerelle unifiée pour plusieurs fournisseurs avec 3 points d’entrée de protocoles officiels : Anthropic / OpenAI / Gemini. Chacun des trois formats permet d’appeler tous les modèles de la passerelle. Facturation selon les jetons consommés × le prix officiel × le coefficient du groupe tarifaire utilisé par votre clé, sans frais mensuels fixes.
Informations de base
- Authorization: Bearer sk-nc-... (Gemini prend aussi en charge x-goog-api-key / ?key=)
- Après connexion, créez une clé dans « Services IA → Clés API »
- Prix officiel en USD/MTok × coefficient du groupe tarifaire ; si le groupe a des heures creuses, les requêtes envoyées pendant ces heures sont en plus multipliées par le coefficient d’heures creuses. Prélevé à l’avance sur le solde ; les appels en streaming sont régularisés de façon asynchrone à leur fin
- Vous pouvez appeler GPT avec le SDK Anthropic ou Claude avec le SDK OpenAI — la passerelle traduit automatiquement les protocoles
3 formats d’appel
Anthropic /v1/messages
Utilise le protocole messages de Claude ; SDK le plus répandu (@anthropic-ai/sdk / anthropic pour Python)
OpenAI /v1/chat/completions
Protocole OpenAI Chat Completions ; prend en charge tools, le streaming et le multimodal
Gemini /v1beta/models/...
Protocole natif Google Gemini ; le modèle dans le chemin détermine le routage
Niveaux de service et de vitesse
La passerelle transmet toujours les requêtes au niveau standard et facture le prix standard ; il n’existe ni niveau réduit ni niveau plus rapide :
- service_tier (flex / fast / priority, etc.) est retiré du corps des requêtes au format OpenAI
- speed (mode rapide) est retiré du corps des requêtes au format Anthropic
- L’en-tête X-Service-Tier n’a aucun effet ; les requêtes qui l’envoient sont traitées au niveau standard
Codes d’erreur
- 401 — Clé API invalide ou désactivée
- 402 insufficient_balance — Solde insuffisant : le solde disponible (après frais non réglés) est ≤ 0 ou ne couvre pas le montant réservé pour cette requête (estimé à partir des limites de contexte et de sortie du modèle, plus « recherches max × prix unitaire » en cas de recherche web côté serveur) ; le message d'erreur indique la réservation nécessaire et le disponible. Rechargez et réessayez. Sous $5 de solde disponible, les réponses portent X-Tovanix-Balance-Low: 1 et X-Tovanix-Balance-Available (USD) pour prévenir à l'avance
- 402 quota_exceeded — Le plafond mensuel de dépenses de la clé est atteint ; il se réinitialise le mois prochain. Vous pouvez aussi le modifier avec « Modifier le plafond » sur la page « Clés API » de la console (vérification d’identité requise)
- 403 group_unavailable — Le groupe tarifaire que cette clé utilise pour le fournisseur du modèle a été désactivé. Changez le groupe de la clé sur la page des clés API ; la passerelle ne bascule jamais d’elle-même vers un autre groupe
- 503 no_upstream_available — Le modèle n’a aucune route disponible dans le groupe tarifaire de votre clé (routes désactivées ou temporairement en pause). Réessayez plus tard ou, si ce fournisseur a plusieurs groupes, changez le groupe de la clé sur la page des clés API
- 502 — Le service du modèle est temporairement indisponible ou a renvoyé une réponse illisible ; réessayez plus tard
Autres points d’accès
Outre le chat, la passerelle propose aussi :
GET /v1/models
Listez les modèles actuellement routables (compatible OpenAI ; fonctionne avec models.list() du SDK)
POST /v1/embeddings
Embeddings de texte (compatible OpenAI ; envoyez input, recevez des vecteurs ; facturation par jeton)
Exemples Python / Node.js
Pour le Playground complet, les tarifs et les journaux d’appels, ouvrez Espace utilisateur → Services IA.
Questions fréquentes
Combien de code faut-il modifier pour migrer depuis l'API d'un fournisseur ?
Généralement seulement base_url et api_key. La passerelle est directement compatible avec les SDK et protocoles officiels ; corps de requête, structures de réponse et formats de streaming restent identiques.
Le streaming est-il pris en charge ?
Oui. Le streaming SSE est entièrement pris en charge, stream=true fonctionne directement avec les SDK officiels et la latence du premier jeton correspond à l'accès direct au fournisseur.
Pages connexes: Services IA · Documentation API · Solution IA mondiale
Chargement…