Recharger l'API Grok : passerelle, facturation et factures (2026)

L'API Grok fonctionne en prépaiement et à la consommation. Sans solde disponible, les requêtes échouent directement, avec un message insufficient quota ou une erreur de droits peu explicite. Pour les équipes basées en Chine, le véritable point de blocage est rarement la capacité du modèle : c'est la recharge. Quelle devise utiliser, comment le taux de change est calculé, en combien de temps le crédit arrive, une facture est-elle possible, le solde est-il remboursable ?

Cet article sépare les deux voies, officielle et passerelle, et propose des points de contrôle avant la recharge, à l'arrivée du crédit et lors du rapprochement comptable. Les prix unitaires, taux de change et offres applicables sont ceux affichés dans la page Tarifs des modèles et sur la page de recharge ; cet article ne fixe aucun chiffre.

Remarque : xAI et Grok sont des marques de leurs détenteurs respectifs. Cet article est fourni à titre technique. Les moyens de paiement, les prix et les règles de facturation peuvent évoluer ; faites foi aux pages officielles de xAI et à la page Tarifs des modèles.

1. Distinguez d'abord les deux voies de recharge

Voie A : compte officiel xAI

Configurez la facturation dans la console xAI, associez un moyen de paiement accepté et achetez des crédits selon vos besoins. L'avantage est un titulaire de facturation clair et un accès direct aux modèles dès leur mise en ligne ; en contrepartie, il faut disposer d'un moyen de paiement international utilisable, accéder de façon stable à la console et gérer soi-même le taux de change, la fiscalité et les notes de frais.

Cette voie convient aux équipes disposant d'une entité ou d'un canal de paiement à l'étranger et utilisant principalement Grok.

Voie B : passerelle IA locale

Créez un compte sur ZSQH AI Gateway, rechargez le solde du compte en yuans, puis appelez Grok avec la clé API du même compte. La passerelle fournit généralement un point d'entrée compatible OpenAI : un SDK OpenAI existant demande seulement de changer l'URL de base et la clé.

Cette voie convient aux équipes qui paient en Chine, ont besoin de factures en yuans, utilisent plusieurs fournisseurs de modèles et souhaitent consulter toute la consommation dans une seule console. Les deux voies ne se remplacent pas : elles diffèrent par le titulaire de la facturation et le périmètre d'exploitation.

Élément	xAI officiel	Passerelle IA locale
Devise de règlement	Selon la facture officielle	Yuan chinois
Moyen de paiement	Moyens acceptés par la plateforme	Moyens courants en Chine
Délai de crédit	Dépend du canal de paiement	Paiement en ligne généralement rapide, virement d'entreprise parfois à confirmer
Facture	Selon la politique officielle	À demander selon les règles de la passerelle
Périmètre de modèles	Modèles de xAI	Plusieurs modèles déjà activés
Périmètre d'exploitation	Réseau et paiement à votre charge	Point d'entrée et facturation intégrés par la plateforme

2. Procédure de recharge officielle chez xAI

Connectez-vous à la console xAI et vérifiez le titulaire du compte, l'adresse de facturation et les conditions d'utilisation.
Ouvrez la page de facturation ou de crédits pour consulter le solde, le mode de facturation et les moyens de paiement disponibles.
Associez un moyen de paiement et vérifiez la devise de débit, l'éventuelle commission transfrontalière et l'emplacement du détail de facturation.
Achetez d'abord un petit crédit et effectuez un appel pour confirmer que le crédit et la facturation fonctionnent, puis complétez selon l'usage réel.
Si la console propose la recharge automatique, définissez un seuil de déclenchement et un montant unitaire raisonnables pour éviter une interruption en cas de pic.
Conservez le numéro de commande, le reçu de paiement et une capture de la page de facturation pour la comptabilité.

Les noms des menus et les options de paiement peuvent varier selon la région et la version ; référez-vous à la page réelle. Avant de payer, vérifiez trois points : la devise de débit, la méthode de conversion et le crédit attendu. Si la page indique seulement « recharge réussie » sans préciser la conversion, confirmez auprès du prestataire avant un paiement important.

3. Procédure de recharge via la passerelle

Ouvrez ZSQH AI Gateway, créez un compte et connectez-vous.
Dans la page de recharge, choisissez un montant et vérifiez le moyen de paiement, le crédit attendu et les éventuelles conditions promotionnelles.
Effectuez le paiement et conservez le numéro de commande et le justificatif.
Revenez à la console et comparez les pages « solde » et « opérations » pour vérifier leur cohérence.
Créez ou sélectionnez une clé API et fixez un plafond de quota par projet.
Validez avec une requête minimale que la clé, le solde et le modèle fonctionnent.
Une fois le contrôle terminé, complétez le solde selon le volume d'activité.

Le point clé d'une recharge via passerelle n'est pas « d'avoir payé », mais que « les comptes correspondent ». Pour un compte d'entreprise, intégrez recharge, facturation, usage et rapprochement dans un même processus, afin de ne pas découvrir en fin de mois que le numéro de commande et le montant de la facture divergent.

4. Taux de change, frais et crédit effectif

La passerelle règle en yuans et doit convertir la devise pour payer son fournisseur en amont. Le coût comporte généralement trois niveaux : le taux de règlement, les frais du canal de paiement et les frais de service de la plateforme. Utilisez la formule suivante pour vérifier :

crédit effectif = montant payé en yuans ÷ taux de règlement − frais de canal − frais de service

Vous n'avez pas besoin de mémoriser de chiffres : il suffit de vérifier trois éléments sur la page de recharge :

Sur quelle ligne figure le taux de change, et s'agit-il d'un taux en temps réel, de fin de journée ou fixe.
Si les frais sont indiqués séparément, s'ils sont intégrés au taux par une marge ou facturés en plus.
Si le crédit effectif suit la formule ci-dessus et peut être recalculé à partir du montant de la commande.

Distinguez par ailleurs le « solde en espèces » du « solde offert ». Le crédit offert n'est généralement ni remboursable ni facturable, peut avoir une date d'expiration et être débité après le solde en espèces. Pour un budget d'entreprise, tenez une comptabilité séparée des deux, sinon des écarts apparaissent en fin de mois.

5. Liste de vérification à l'arrivée du crédit

Après la recharge, contrôlez les points suivants dans l'ordre ; cela évite la plupart des cas « paiement réussi mais solde absent » :

Conservez le numéro de commande, l'heure du paiement et le montant payé, avec une capture d'écran.
Comparez la page de solde et la page des opérations pour vérifier que le montant crédité correspond à la commande.
Vérifiez si la clé possède un plafond de quota distinct, pour éviter un solde suffisant mais une clé plafonnée.
Confirmez que le modèle demandé est activé sur le compte ou dans le groupe courant.
Si le débit a réussi mais que le solde n'a pas changé, contactez le support avec le numéro de commande ; ne payez pas une seconde fois.
Avant une recharge importante, validez le circuit avec un petit montant : paiement, crédit et appel.

Le délai de crédit dépend du canal de paiement. Le paiement en ligne est généralement rapide ; un virement d'entreprise peut nécessiter une confirmation manuelle, et les virements interbancaires ou hors jours ouvrés peuvent être retardés. Prévoyez cette marge dans le calendrier des achats et n'attendez pas le jour de la mise en service pour recharger.

6. Factures et rapprochement comptable

Élément	À vérifier
Type de facture	Facture de TVA ordinaire ou spéciale
Titulaire	Raison sociale, numéro fiscal, adresse et téléphone, banque et numéro de compte
Montant	Facturé sur le montant payé ou sur le crédit effectif
Délai	Sous quel délai après paiement, et possibilité de facturation a posteriori
Justificatifs	Numéro de commande, contrat et reçu de paiement réunis
Règles de correction	Traitement d'une facture erronée, d'une réémission ou d'un avoir

Pour un achat d'entreprise, mieux vaut inscrire les exigences de facturation dans le bon de commande plutôt que de les demander après paiement. Pour un test individuel, commencez par une petite recharge et n'ajoutez du solde qu'après avoir confirmé le modèle et le circuit, afin d'éviter un solde inutilisé. Conservez les relevés de recharge, les numéros de commande et les factures pendant au moins un cycle comptable : ils servent au rapprochement.

7. Premier appel après la recharge

Une fois le solde crédité, confirmez l'ensemble du circuit avec une requête minimale :

export GROK_API_KEY="sk-votre_cle"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $GROK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4",
    "messages": [{"role": "user", "content": "Réponds uniquement OK"}],
    "max_tokens": 16
  }'

Un code 200 avec un champ choices indique que la clé, le solde et le modèle fonctionnent. Si la réponse signale un problème de quota, procédez dans cet ordre :

Vérifiez si le solde a été crédité et si l'opération apparaît dans le relevé.
Vérifiez si la clé possède un plafond de quota.
Vérifiez si le modèle demandé est activé sur le compte.
Vérifiez s'il s'agit d'une limitation de débit ou de concurrence plutôt que d'un problème de solde.
Vérifiez que l'URL de base correspond à l'origine de la clé.

Questions fréquentes

Recharge et abonnement sont-ils la même chose ?

Non. L'abonnement concerne l'usage des produits par une personne ; la recharge API concerne les appels programmatiques. Les quotas ne sont généralement pas interchangeables et ne se déduisent pas l'un de l'autre. Lors d'un achat, précisez bien lequel des deux vous prenez.

Après une recharge en yuans, la facture est-elle en dollars ou en yuans ?

Cela dépend du prestataire. Une passerelle émet généralement une commande et une facture en yuans, tandis que la page d'usage peut afficher la consommation en dollars pour faciliter le rapprochement avec l'amont. La page de facturation réelle fait foi.

Combien de temps faut-il pour que le crédit arrive ?

Le paiement en ligne est généralement rapide ; un virement d'entreprise peut nécessiter une confirmation manuelle, selon le canal et les indications de la plateforme. Pour une recharge importante, prévoyez une marge d'au moins un jour ouvré.

Le solde non utilisé est-il remboursable ?

Cela dépend des conditions de la plateforme. Les règles diffèrent pour le solde en espèces non utilisé, le crédit offert et les sommes déjà consommées ; vérifiez-les au moment de la recharge plutôt que d'attendre de ne plus en avoir besoin.

Pourquoi deux requêtes identiques sont-elles facturées différemment ?

La longueur d'entrée, la longueur de sortie, l'utilisation du cache, le niveau de modèle et les appels d'outils influencent la facturation. Comparez l'identifiant de requête avec les journaux d'usage pour localiser l'écart.

Pour aller plus loin

Si vous avez besoin d'une recharge en yuans, d'une facturation unifiée et de factures en yuans tout en appelant Grok et d'autres modèles, commencez par créer un compte ZSQH AI Gateway, validez une requête avec un petit crédit, puis répartissez les clés par projet. Les prix, taux de change et règles de facturation applicables sont ceux de la page Tarifs des modèles.