Appeler l'API Gemini depuis la Chine ne pose généralement pas de difficulté de code, mais de liaison : les requêtes sortent-elles de façon stable, la latence est-elle acceptable, le quota suffit-il et qui traite les incidents ? Beaucoup d'équipes font d'abord fonctionner un proxy personnel, puis amènent la même configuration en production et doivent reprendre le travail sur la concurrence, la limitation de débit et la conformité.

Cet article répartit les solutions courantes en trois catégories : connexion directe, proxy auto-hébergé et passerelle IA locale, en précisant les limites d'usage, le traitement des quotas et la méthode de mise en production. Conclusion préalable : en phase de prototype, privilégiez la simplicité ; en production, choisissez selon trois critères — supervisable, dégradable et explicable en conformité.

Remarque : Google et Gemini sont des marques de leurs détenteurs respectifs. Cet article décrit les conditions réseau et d'interface courantes en octobre 2026 ; les régions de service, quotas et conditions sont ceux des pages officielles. Respectez la législation locale et les conditions d'utilisation des plateformes.

1. Comparaison des trois solutions

Dimension Connexion directe Proxy auto-hébergé Passerelle IA locale
Disponibilité typique Fortement dépendante du réseau et de la région Dépend de la qualité de la sortie Assurée par le prestataire, page d'état consultable
Latence Fluctuations marquées Optimisable, mais un saut supplémentaire Généralement plus stable
Coût d'exploitation Faible, mais diagnostic difficile Élevé : serveurs et sortie à maintenir Faible, usage par interface
Quotas Limités par le débit et la région officiels Ne modifient pas le quota officiel Répartis et limités côté passerelle
Facturation Dollars, facturation à l'usage Coût officiel plus coût serveur Yuans, prépayé
Justification de conformité Chaîne transfrontalière à expliquer soi-même Responsabilité de la sortie et des journaux Contrat local et périmètre de service
Scénarios adaptés Vérification personnelle, tâches peu sensibles Systèmes internes avec équipe réseau Activité de production tournée vers le client

Ce tableau ne décide pas à votre place ; il rappelle qu'un proxy ne règle que la connectivité, pas les quotas, la facturation ni la conformité. Traiter un proxy comme une solution de production durable revient à laisser l'incertitude dans la chaîne.

2. Connexion directe : distinguer réseau et autorisation

Les échecs de connexion directe relèvent de trois cas, à examiner dans cet ordre :

  1. Région non couverte : dans une région non desservie, la requête peut expirer ou être refusée ; changer de clé n'y remédie pas.
  2. Réseau indisponible : résolution DNS, poignée de main TLS et routage de sortie peuvent échouer ; utilisez curl -v pour voir où cela bloque.
  3. Authentification ou projet : un 401 indique un problème de clé ; un 403 vient le plus souvent du projet, d'une API non activée ou d'un droit sur le modèle.
export GEMINI_API_KEY="votre clé"

curl -v "https://generativelanguage.googleapis.com/v1beta/models" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  --max-time 15

Si la connexion expire dès l'établissement, régler les paramètres ensuite n'a pas de sens ; si la connexion aboutit mais renvoie un 4xx, poursuivez le diagnostic par code de statut. Notez à chaque échec l'étape, la durée et le code afin de distinguer une fluctuation ponctuelle d'une indisponibilité structurelle.

3. Proxy auto-hébergé : la connectivité, pas les quotas

La structure typique est : serveur métier → sortie à l'étranger → API Gemini. Elle convient aux équipes capables d'exploiter le réseau et dont la sensibilité des données est maîtrisée, à condition d'inscrire quatre points dans le manuel d'exploitation :

  • La stabilité de l'IP de sortie et le risque d'être considéré comme trafic anormal par le service cible.
  • L'enregistrement éventuel du contenu des requêtes par le proxy, la durée de conservation des journaux et les personnes qui y ont accès.
  • La gestion des certificats, domaines et ports, ainsi que l'alerte en cas d'expiration.
  • La bande passante, la concurrence et la bascule du serveur proxy lui-même.

Un proxy n'augmente pas le quota officiel. Les limites RPM et TPM du palier gratuit ou bas restent en vigueur et la file d'attente apparaît aux heures de pointe. Le problème le plus courant est un point de sortie partagé par toute l'activité : un script qui s'emballe bloque toute la chaîne. Il est donc nécessaire de séparer les sorties et les limites par activité.

4. Intégration via une passerelle : généralement trois changements

Une passerelle IA locale expose en général un point d'entrée compatible OpenAI ; le code existant ne nécessite que le changement de l'URL de base, de la clé et du nom de modèle :

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ZSQH_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="<nom du modèle Gemini indiqué sur la page des tarifs>",
    messages=[{"role": "user", "content": "Réponds seulement OK"}],
    max_tokens=64,
)
print(resp.choices[0].message.content)
print(resp.usage)

Le nom du modèle est celui de la page Tarifs des modèles ; ne recopiez pas l'exemple. Après l'intégration, exécutez une requête minimale, puis un lot de tâches réelles en observant trois éléments : la latence du premier token, le taux d'échec et l'éventuelle dégradation du contenu retourné. La passerelle est une frontière de service : avant de la choisir, vérifiez la page d'état, les canaux de support, les règles de remboursement et les clauses de données.

5. Quotas et 429 : bien écrire les nouvelles tentatives

Les quotas Gemini sont généralement calculés par modèle, par projet et par fenêtre temporelle, selon des dimensions telles que les requêtes par minute, les tokens par minute et les requêtes par jour. Le dépassement renvoie généralement un 429, et le traitement détermine si l'incident va s'amplifier :

  1. Retrait exponentiel avec gigue aléatoire, pour éviter que tous les clients réessaient au même instant.
  2. Nombre maximal de tentatives et délai global : au-delà, dégrader plutôt que renvoyer sans fin.
  3. Mise en file par priorité métier : les requêtes interactives passent avant les lots hors ligne.
  4. Écritures idempotentes pour éviter les effets de bord en double lors d'une nouvelle tentative.
  5. Surveillance de la répartition temporelle des 429 pour distinguer une limite à la minute d'un quota journalier épuisé.
  6. Modèle ou canal de secours prêt, avec bascule automatique lorsque le canal principal est limité.

Si le quota journalier est épuisé, réessayer ne sert à rien : réduisez le palier, diminuez les appels non critiques ou ajustez le quota. En cas de pic de concurrence, limitez d'abord puis augmentez la capacité ; l'ordre inverse ne fait que ralentir toute la chaîne.

6. Conformité et données : trois questions incontournables

  1. Les requêtes contiennent-elles des données personnelles, des contrats clients, du code ou des données financières ?
  2. Par quels nœuds les données passent-elles, dans quelles régions sont-elles stockées et combien de temps les journaux sont-ils conservés ?
  3. En cas d'incident de sécurité, qui peut fournir les enregistrements et à quelle vitesse la notification arrive-t-elle ?

Plus la chaîne transfrontalière est longue, plus la justification est coûteuse. Pour un système de production tourné vers le client, classifiez les données et anonymisez d'abord les champs sensibles ; si des journaux doivent être conservés, définissez clairement les droits d'accès et la procédure de suppression. Ne sautez pas l'évaluation de conformité sous prétexte qu'« il s'agit seulement d'un appel d'API ».

7. Étapes de mise en production

  1. Réaliser une semaine de test de charge avec des tâches réelles, en couvrant pics et creux.
  2. Relever le taux de réussite, la latence p50 et p95, la répartition des 429 et le coût par tâche.
  3. Comparer le plafond de quota au pic métier et conserver une marge.
  4. Brancher la supervision et les alertes : taux d'erreur, latence, solde et limitation.
  5. Tester la bascule principal/secours et vérifier que la dégradation reste acceptable pour l'activité.
  6. Archiver contrat, facture, clauses de données et notice de sécurité.
  7. Basculer à faible volume et observer une semaine avant le déploiement complet.

Questions fréquentes

Peut-on appeler directement l'API Gemini depuis la Chine ?

La connexion directe dépend de la région de service officielle, de la sortie réseau et de l'état du compte ; le résultat peut être un délai dépassé, une réinitialisation de connexion ou un 4xx. Ne concluez pas sur un seul succès ou échec : jugez sur une semaine de taux d'échec et de distribution des latences.

Un proxy est-il stable ?

Un proxy améliore la connectivité, mais la stabilité dépend de la qualité de la sortie, de la concurrence et du niveau d'exploitation. Il ne modifie pas le quota officiel et ne règle pas automatiquement la conformité ni les journaux ; un usage en production exige une supervision et une dégradation complètes.

Pourquoi toujours recevoir des 429 ?

Cela peut venir d'une limite de débit à la minute, d'un quota journalier épuisé ou d'un pic de concurrence. Consultez d'abord les en-têtes de réponse et la page d'usage pour identifier le type ; lorsque le quota journalier est épuisé, réessayer est inutile : ajustez le quota ou réduisez les appels non critiques.

Une passerelle modifie-t-elle les capacités du modèle ?

La passerelle assure surtout l'authentification, le routage, la limitation de débit et la facturation ; elle ne modifie normalement pas le modèle. Mais le périmètre de modèles, les paramètres pris en charge et les versions peuvent différer selon le canal : comparez avec le même lot de tâches avant la mise en production.

Quels points de conformité vérifier pour l'accès depuis la Chine ?

Vérifiez au minimum si les données traversent une frontière, si elles contiennent des données personnelles, combien de temps les journaux sont conservés et si le prestataire peut fournir contrat et notice de sécurité. Anonymisez d'abord les données sensibles et suivez la procédure d'évaluation de l'entreprise.

Pour aller plus loin

Si vous ne souhaitez pas maintenir de proxy ni de sortie réseau, commencez par exécuter une requête Gemini via ZSQH AI Gateway, puis séparez les clés par projet et fixez un budget. Les modèles disponibles et les prix sont ceux de la page Tarifs des modèles.

Lectures associées :