L'API Moonshot fonctionne en prépayé : il faut du solde sur le compte pour appeler. Trois décisions sont sources d'erreur : sur quel site recharger, quelle entité paie, et selon quelle base la facture est émise. Cet article décompose le processus d'achat pour la recharge officielle et via passerelle, en couvrant devise, factures, alertes de solde, remboursement et notes de frais. Les tarifs exacts font foi sur Tarifs et modèles.

Note : Moonshot et Kimi sont des marques de leurs titulaires. Cet article décrit des aspects techniques et un processus d'achat ; il n'implique aucune relation de filiale ou d'agence avec les titulaires. Les règles de recharge, la politique de facturation et les conditions de remboursement peuvent évoluer : avant toute opération, référez-vous à l'accord de recharge officiel et aux indications de la page.

I. Vérifier d'abord sur quel compte recharger

En octobre 2026, l'ancien domaine de documentation platform.moonshot.cn redirige vers platform.kimi.com, et le site international vers platform.kimi.ai. Les deux sites sont indépendants : une clé du site chinois appelée sur le site international renvoie 401, et les soldes ne sont pas partagés. Un rechargement sur le mauvais site ne sera pas disponible.

Type de compte Point d'entrée Devise de règlement Cas d'usage
Site officiel chinois platform.kimi.com Yuan Entité et activité en Chine, facture en yuans
Site officiel international platform.kimi.ai Selon la page de facturation Entité hors Chine, paiement à l'étranger
Passerelle IA ZSQH Console du service Yuan Recharge et facturation multi-modèles unifiées

Avant l'achat, vérifiez l'URL de base et l'origine de la clé, puis faites confirmer l'entité bénéficiaire par la finance. Les projets d'une même organisation partagent généralement le solde, mais chacun peut définir son budget, afin d'éviter « de l'argent rechargé mais aucun quota pour le projet ».

II. Recharge officielle : deux voies, particuliers et entreprises

Les particuliers effectuent d'abord la vérification d'identité, puis paient par WeChat ou Alipay. Les entreprises commencent par la vérification d'entreprise, avec généralement la raison sociale, le code de crédit social unifié et un compte bancaire au nom de l'entité ; la plateforme peut virer un montant aléatoire sur le compte d'entreprise, que la finance doit confirmer.

Deux canaux pour les entreprises : le paiement en ligne par QR code, crédité immédiatement ; le virement, qui prend généralement un à cinq jours ouvrés, avec un crédit environ dix minutes après confirmation. Anticipez les passages de mois.

  1. Connectez-vous au site chinois et vérifiez le nom de l'organisation et l'état de vérification.
  2. Les particuliers complètent la vérification personnelle ; les entreprises, la vérification d'entreprise et du compte bancaire.
  3. Ouvrez la page de recharge et vérifiez l'entité bénéficiaire et le site courant.
  4. Lisez l'accord de recharge, choisissez le montant et le mode de paiement ; pour un montant important, l'entreprise paie par virement depuis le compte certifié.
  5. Conservez le justificatif, suivez le crédit, vérifiez le solde dans la page de facturation et configurez une alerte de solde bas.
  6. Envoyez une requête minimale pour confirmer la clé, l'URL de base et le solde.

L'entité payeuse doit correspondre à l'entité certifiée. Un paiement d'une filiale, d'une société affiliée ou d'une personne physique peut être rejeté, voire déclencher un contrôle des risques. Si un tiers déclare un paiement non autorisé, la plateforme peut bloquer le compte et les clés ; l'utilisateur doit alors fournir une preuve d'autorisation dans le délai imparti. N'utilisez pas le compte personnel d'un salarié pour une recharge importante.

III. Devise, taux de change et paiement transfrontalier

Le site chinois facture et règle en yuans ; les entités en Chine paient par WeChat, Alipay ou virement. Le site international règle dans la devise de la page de facturation, et les réseaux de cartes étrangers peuvent appliquer des frais de conversion ; le taux dépend de la banque émettrice ou du canal de paiement. Les soldes des deux sites ne sont pas transférables et les factures ne se compensent pas entre eux.

La recharge via passerelle est généralement libellée en yuans, et la page de paiement indique le montant dû et la base de facturation. Avant de payer, vérifiez si le prix inclut les taxes, si des frais de canal s'ajoutent et quelle entité émet la facture.

Pour un achat transfrontalier, l'entité contractante et l'entité payeuse doivent rester identiques, sinon l'audit demandera des explications. En période de forte volatilité des changes, prévoyez une marge budgétaire plutôt que de figer le budget annuel au taux du jour.

IV. Comment établir la facture

Une demande peut être déposée depuis la page de facturation, selon deux bases courantes : le montant rechargé ou le montant réellement consommé. La facturation sur recharge facilite le remboursement anticipé, mais la partie non consommée est déjà facturée ; la facturation sur consommation reflète mieux le coût réel, mais exige des demandes régulières. La possibilité de changer de base et la fréquence dépendent de la page.

Un compte vérifié en tant que particulier peut obtenir une facture à son nom ou au nom d'une société ; un compte entreprise ne peut facturer qu'à l'entité certifiée. La page financière officielle indique que l'émetteur est Beijing Moonshot Technology Co., Ltd., avec la rubrique « frais de services techniques » et une TVA de 6 %. La rubrique, le taux et les mentions réels font foi sur la page de facturation.

Avant d'émettre, vérifiez le nom et le numéro fiscal, la base de facturation, le type de facture et les mentions. Une erreur de nom impose un avoir et une réémission, ce qui prend du temps et bloque souvent les notes de frais en fin de mois. Les factures de passerelle suivent les règles de la passerelle ; un achat multi-modèles peut être couvert par une seule facture, à condition de vérifier l'entité et la rubrique avant paiement.

V. Solde, alertes et limitations

Une interface officielle permet de consulter le solde et de l'intégrer à la supervision. Le solde du site chinois est libellé en yuans ; available_balance inclut généralement les espèces et les bons. S'il est inférieur ou égal à zéro, les requêtes d'inférence échouent avec exceeded_current_quota_error. La réponse contient aussi data.cash_balance et data.voucher_balance ; une clé ne correspondant pas au site renvoie généralement 401.

curl "https://api.moonshot.cn/v1/users/me/balance" \
  -H "Authorization: Bearer $MOONSHOT_API_KEY"

La supervision doit couvrir quatre niveaux :

  • Alerte de solde : la console permet une alerte SMS de solde bas, avec un seuil ajusté à la vitesse de consommation.
  • Hausse brutale de la consommation quotidienne : déclenchement lorsque la valeur dépasse nettement la moyenne des sept derniers jours.
  • Budget par projet : budget journalier ou mensuel, les requêtes étant refusées au plafond, avec un délai d'application d'environ dix minutes.
  • Classification des échecs : distinguer solde insuffisant, limitation de débit, surcharge de capacité et erreur serveur.

Le montant rechargé influence aussi le niveau du compte. La plateforme classe les comptes selon le cumul des recharges ; le niveau détermine les limites de concurrence, RPM, TPM, TPD et QPS de recherche. Les bons ne sont généralement pas comptés dans le cumul. À l'achat, considérez ensemble solde et limites, sinon vous aurez de l'argent sans pouvoir augmenter la concurrence.

VI. Remboursement, validité du solde et litiges

L'accord de recharge officiel prévoit généralement qu'une recharge n'est pas remboursable, sauf arrêt du service pour une cause imputable à la plateforme ; le solde non consommé n'est pas librement retirable, n'a pas de date d'expiration, mais ne peut être transféré ni offert. En cas de violation, la plateforme peut retenir le prépaiement. Avant une recharge importante, faites lire l'accord par le juridique et la finance : ce n'est pas un dépôt disponible à tout moment.

Un paiement par un tiers, une avance de salarié ou un paiement d'une société affiliée peut créer un litige de propriété. Conservez contrat, justificatif de paiement, autorisation et facture pour disposer des pièces en cas de blocage ou de contestation. Commencez par un petit test pour vérifier clé, solde, facture et limites, puis prépayez un montant important.

VII. Recharge via passerelle : quand est-elle préférable ?

La passerelle IA ZSQH est un système de comptes distinct : la recharge alimente le solde de la passerelle, pas le solde officiel Moonshot. Son intérêt est surtout côté achats : paiement en yuans, compte multi-modèles unifié, facture et relevés communs, et changement de modèle sans recharge séparée. En contrepartie, le périmètre des modèles et la prise en charge des paramètres suivent la documentation de la passerelle.

Frontière de choix :

  • Un seul modèle, processus financier simple, besoin des capacités directes officielles : privilégier la recharge officielle.
  • Plusieurs fournisseurs et volonté d'une facture unique couvrant plusieurs sources : la passerelle simplifie.
  • Cœur d'activité en direct, tests via la passerelle.

Après inscription sur la passerelle IA ZSQH, la page de recharge indique la devise et les modalités de facturation. Les tarifs et bases de facturation font foi sur Tarifs et modèles.

VIII. Liste d'achat pour l'entreprise

Faites confirmer les points suivants par la finance, le juridique et le responsable métier :

  1. Cohérence de l'entité utilisatrice, du site, du nom d'organisation et de l'URL de base.
  2. État de vérification et compte bancaire conformes aux exigences de recharge entreprise.
  3. Montant, devise, canal de paiement et délai de crédit prévu.
  4. Nom et numéro fiscal du destinataire, rubrique, taux, base et périodicité de facturation.
  5. Niveau de compte et limites de concurrence, RPM, TPM, TPD compatibles avec les pics.
  6. Alertes de solde bas et budgets journaliers/mensuels par projet configurés.
  7. Contrat, bon de commande, justificatif de paiement, facture et relevé rapprochables.
  8. Conditions de remboursement et clause de non-transfert du solde communiquées aux personnes concernées.

Questions fréquentes

Pourquoi le solde n'apparaît-il pas après la recharge ?

Le paiement par QR code est généralement immédiat ; le virement prend un à cinq jours ouvrés, avec un crédit environ dix minutes après confirmation. Vérifiez d'abord que l'entité payeuse correspond à l'entité certifiée, puis le justificatif et le relevé.

Que faire en cas de recharge sur le mauvais site ?

Les soldes et les clés du site chinois et du site international ne sont pas partagés. Arrêtez la recharge, conservez les preuves et suivez les instructions du support, sans multiplier les tentatives.

Facture sur recharge ou sur consommation ?

Les deux sont possibles, selon le rythme de remboursement. La facturation sur recharge facilite le remboursement anticipé, mais la partie non consommée est déjà facturée ; celle sur consommation reflète le coût réel mais exige des demandes régulières.

Une recharge d'API Moonshot est-elle remboursable ?

L'accord officiel prévoit généralement qu'une recharge n'est pas remboursable, sauf arrêt du service pour une cause imputable à la plateforme ; le solde non consommé n'est pas librement retirable. Lisez l'accord et consultez le support avant un montant important.

Une recharge augmente-t-elle la concurrence et les limites ?

Le niveau de compte dépend du cumul des recharges et influence la concurrence, les RPM, TPM et TPD ; les bons ne sont généralement pas comptés. Une surcharge de capacité est un problème côté service que la recharge ne supprime pas directement ; référez-vous à la documentation officielle des limites.

Pour aller plus loin

Vérifiez d'abord le site, l'entité et la base de facturation, puis choisissez la recharge officielle ou via passerelle. Une équipe ayant besoin d'un compte multi-modèles en yuans peut s'inscrire sur la passerelle IA ZSQH ; les tarifs et modèles disponibles figurent sur Tarifs et modèles.

Lectures associées :