Tovanix
Tovanix

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…