L'API Gemini accepte le texte, les images, l'audio et la vidéo en entrée, à des tarifs généralement accessibles. Pourtant, l'accès aux services Google depuis certaines régions, les limites de quota et les moyens de paiement restent des obstacles fréquents.
Un relais de l'API Gemini regroupe cet accès et sa facturation derrière une seule passerelle. Cet article explique comment le choisir, l'intégrer et le tester.
Remarque : Gemini et Google sont des marques de leurs détenteurs respectifs. Cet article n'a qu'une vocation d'explication technique ; les tarifs et interfaces applicables sont ceux de l'éditeur et du site.
1. Qu'est-ce qu'un relais de l'API Gemini ?
Votre application → passerelle relais → Google Gemini
Vous appelez toujours les modèles Gemini ; seuls l'URL de base et la clé changent pour celles de la passerelle. Celle-ci gère l'authentification, la facturation, les journaux et la bascule de canaux.
2. À qui s'adresse-t-il ?
- Aux équipes dont l'accès à Google est instable depuis leur région.
- À celles qui ont besoin de capacités multimodales (image, vidéo, audio).
- À celles qui veulent une facturation, des membres et des quotas unifiés.
- Aux équipes qui utilisent simultanément Gemini, Claude, GPT et DeepSeek.
- À celles qui changent souvent de modèle pour des tests A/B.
3. Critères de choix
| Critère | À vérifier |
|---|---|
| Couverture des modèles | Versions Pro, Flash et autres disponibles |
| Multimodal | Prise en charge des entrées image, vidéo et audio |
| Protocole | Compatibilité OpenAI complète ; streaming et appels d'outils fonctionnels |
| Stabilité | Taux d'erreur, P95, limitation de débit |
| Facturation | Calcul de l'entrée, de la sortie et des entrées multimodales |
| Quotas | Plafonds par clé, membre ou projet |
| Conformité | Conservation des données, contrat, factures |
4. Configuration
URL de base :
https://ai.zhongshangqihang.com/v1
curl :
export GEMINI_API_KEY="sk-votre-clé"
curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
-H "Authorization: Bearer $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2.5-flash",
"messages": [{"role": "user", "content": "Réponds seulement OK"}]
}'
Les identifiants de modèles applicables figurent sur la page Tarifs des modèles.
5. Utiliser le multimodal
Les passerelles ne prennent pas toutes en charge le multimodal de la même façon. Deux approches sont courantes :
- Par URL : transmettre l'URL de l'image ou de la vidéo dans
messages. - Par Base64 : encoder le fichier et l'insérer dans la requête.
Avant usage, vérifiez les champs acceptés et les limites de taille auprès de la passerelle ; ne reprenez pas tel quel le format du SDK de l'éditeur. Testez d'abord avec une petite image, puis passez en production.
6. Liste de tests
- Requête texte.
- Sortie en streaming.
- Entrée image.
- Contexte long.
- Concurrence de 5 et 10 requêtes.
- Gestion des erreurs 429 et 5xx.
- Vérification de la facture.
7. Problèmes fréquents
| Symptôme | Cause probable | Traitement |
|---|---|---|
| Délai de connexion dépassé | Google inaccessible | Utiliser une passerelle accessible depuis votre région |
| 401 | Clé ou adresse incorrecte | Vérifier la clé et l'URL de base |
| 404 | Chemin erroné | Ne renseigner que /v1 |
| 429 | Quota ou fréquence dépassés | Réduire la concurrence, réessayer, augmenter le quota |
| Erreur multimodale | Champ ou taille non pris en charge | Consulter la documentation de la passerelle et tester un petit fichier |
8. Connexion directe ou relais ?
| Critère | Connexion directe | Passerelle relais |
|---|---|---|
| Accès | Dépend du réseau | Accessible depuis votre région |
| Paiement | Moyens de l'éditeur | Recharge sur le site |
| Modèles | Gemini uniquement | Plusieurs modèles possibles |
| Facturation | Console de l'éditeur | Console unifiée |
| Multimodal | Capacités complètes de l'éditeur | Dépend de la prise en charge par la passerelle |
Si vous n'utilisez que Gemini et que l'accès direct fonctionne, il peut suffire. Si l'accès est instable ou si vous avez besoin de plusieurs modèles, un relais est plus adapté.
Pour aller plus loin
Pour un accès depuis votre région ou un point d'entrée unique vers plusieurs modèles, vous pouvez créer un compte sur ZSQH AI Gateway et tester le texte et le multimodal avec une clé à faible quota. Les modèles et tarifs applicables sont ceux de la page Tarifs des modèles.
Lectures associées :
