L'API Kimi fonctionne en prépayé : il faut un solde pour appeler, et un solde insuffisant peut renvoyer 403 ou 429. La recharge elle-même n'est pas complexe ; ce qui pose problème, ce sont trois points : à quel site recharger, avec quelle entité payer, et sur quelle base la facture est émise.
Cet article distingue la recharge officielle et la recharge via passerelle, et couvre vérification d'identité, moyens de paiement, délai d'arrivée, facture, surveillance du solde et remboursement d'entreprise. Prix et modèles disponibles sont ceux de la page Tarifs des modèles.
Remarque : Moonshot et Kimi sont des marques de leurs détenteurs respectifs ; cet article ne décrit que les aspects techniques et les procédures d'achat. Les règles de recharge, la politique de facturation et les clauses de remboursement peuvent évoluer : avant toute opération, consultez l'accord de recharge officiel et les indications de la page.
1. Confirmer d'abord à quel compte recharger
| Type de compte | Entrée | Devise de règlement | Usage |
|---|---|---|---|
| Plateforme Kimi, site chinois | platform.kimi.com | Yuan | Entité et activité en Chine |
| Plateforme Kimi, site international | platform.kimi.ai | Selon la page de facture | Entité et activité à l'étranger |
| ZSQH AI Gateway | Console du site | Yuan | Recharge et facture unifiées multi-modèles |
Les soldes et les clés du site chinois et du site international ne sont pas interchangeables. Recharger le site chinois puis appeler avec une clé du site international ne fait pas usage du solde. Le compte passerelle est un autre système : la recharge alimente le solde de la passerelle, pas celui de Kimi.
Avant de payer, vérifiez le nom du compte et le site sur la page de facturation. Pour un achat d'entreprise, contrôlez particulièrement l'entité : la procédure de remboursement après une recharge sur le mauvais compte est généralement bien plus lente.
2. Procédure de recharge officielle
- Se connecter à platform.kimi.com et ouvrir l'espace utilisateur.
- Terminer la vérification d'identité personnelle ; pour un usage d'entreprise, terminer d'abord la vérification d'entreprise.
- Ouvrir la page de recharge et choisir le montant.
- Un particulier choisit le paiement par QR code WeChat ou Alipay.
- Une entreprise peut payer par QR code ou utiliser le compte dédié fourni par la plateforme pour un virement.
- Le virement doit provenir d'un compte bancaire au nom du titulaire vérifié, sinon les fonds peuvent ne pas être crédités.
- Après réception, confirmer le solde sur la page de facturation et définir une alerte.
- Envoyer une requête minimale depuis la console pour vérifier la clé et le solde.
Le virement d'entreprise demande généralement un à cinq jours ouvrés pour atteindre la banque, puis la plateforme crédite le compte en une dizaine de minutes environ. Pour un achat en fin de mois, prévoyez le délai et n'attendez pas le jour de l'épuisement du quota pour lancer le virement.
3. Moyens de paiement et délais
La recharge personnelle passe surtout par un paiement QR code et arrive généralement vite. La recharge d'entreprise offre en plus le virement, adapté aux équipes ayant besoin de contrat, de remboursement et de facture.
Quelques détails sont souvent négligés :
- Émetteur du virement : il doit correspondre au titulaire vérifié ; le paiement par une filiale ou une société affiliée peut être renvoyé.
- Notification d'arrivée : un virement n'est pas instantané ; une personne doit suivre après validation financière, sans attendre uniquement le SMS du système.
- Niveau de recharge : la plateforme classe les utilisateurs selon le cumul des recharges, et le niveau influence la concurrence et la limitation ; les bons ne comptent pas dans le cumul.
- Change et frais : le site international règle dans la devise de la page de facture, et un paiement transfrontalier peut entraîner des frais de conversion ; pour la passerelle en yuans, la conversion éventuelle est indiquée sur la page de paiement.
- Montant minimal : l'existence d'un minimum et d'un plafond par opération dépend des indications de la page de recharge ; aucun chiffre n'est figé ici.
Si l'activité a des exigences de concurrence précises, vérifiez le niveau et les limites actuels avant de recharger, pour éviter « les fonds sont arrivés mais la concurrence ne suit pas ». Les règles de limitation sont celles de la documentation officielle.
4. Comment obtenir une facture
La plateforme permet une demande en ligne depuis la page de gestion des factures, avec deux bases courantes :
| Base de facturation | Usage | Attention |
|---|---|---|
| Sur le montant rechargé | Recharge préalable puis consommation, remboursement anticipé | La partie non consommée est déjà facturée, le remboursement est plus complexe |
| Sur le montant consommé | Règlement selon l'usage réel | Demande régulière, adaptée au rapprochement mensuel |
Un particulier vérifié peut demander un intitulé personnel ou une facture au nom de son entreprise ; un compte d'entreprise ne peut obtenir qu'une facture au nom du titulaire vérifié. Le contenu est généralement une prestation de services techniques ; la dénomination exacte, le taux de taxe et les mentions figurent sur la page de facturation.
Avant d'émettre, confirmez trois points : l'intitulé et le numéro fiscal correspondent aux exigences financières, la base est la recharge ou la consommation, et le type de facture convient au remboursement. Découvrir une erreur d'intitulé après coup impose un avoir et une réémission, avec des délais.
La recharge via passerelle suit les règles de facturation de la passerelle. Pour un achat multi-modèles unifié, une seule facture couvre plusieurs modèles et simplifie le rapprochement, mais il faut demander avant paiement la devise, l'entité émettrice et la dénomination.
5. Solde, alertes et rapprochement de l'usage
La plateforme fournit une interface de consultation du solde, intégrable à votre supervision :
curl "https://api.moonshot.cn/v1/users/me/balance" \
-H "Authorization: Bearer $MOONSHOT_API_KEY"
Le contenu retourné dépend de la réponse réelle ; utilisez le champ de solde disponible. Ne dépendez pas uniquement de la console : le système métier doit avoir sa propre alerte de solde.
Prévoyez quatre niveaux de surveillance :
- Alerte de seuil : notification par SMS ou messagerie d'entreprise sous un montant prédéfini.
- Alerte de hausse quotidienne : déclenchement quand la consommation du jour dépasse un multiple de la moyenne des sept derniers jours.
- Rapprochement par projet : ventilation par clé, projet et modèle pour identifier les appels qui croissent le plus vite.
- Suivi des requêtes échouées : distinguer impayé, limitation et erreur serveur, pour ne pas traiter tous les 429 comme un problème de solde.
L'alerte de solde ne prévient que la « coupure soudaine » ; elle ne remplace pas la gestion budgétaire. Fixer un plafond mensuel par projet est plus maîtrisable que recharger quand le compte est à zéro.
6. Remboursements, bons et validité
Lisez l'accord de recharge avant de payer. L'existence d'un remboursement, ses conditions et son délai suivent l'accord et la réponse du support ; ne présumez pas que « ce qui n'est pas utilisé est remboursable ».
Trois points concernant les bons :
- Ils ont généralement un périmètre d'application ; certains modèles peuvent être exclus.
- Ils ne comptent généralement pas dans le cumul de recharge et n'élèvent pas le niveau de limitation.
- Leur expiration et leur cumul éventuel suivent les mentions du bon.
Un achat d'entreprise ne doit pas intégrer les bons au budget. Établissez le budget sur la recharge en espèces et traitez les bons comme une marge de sécurité.
7. Recharge officielle ou recharge via passerelle
La recharge via passerelle est généralement plus courte : se connecter à la console, choisir le montant, payer en ligne, confirmer le solde. Canaux de paiement, montant minimal et règles de facturation suivent la page de recharge de la passerelle.
| Critère | Recharge officielle | ZSQH AI Gateway |
|---|---|---|
| Devise | Yuan (site chinois) | Yuan |
| Paiement | WeChat, Alipay, virement | Selon la page de recharge de la passerelle |
| Facture | Demande sur la page officielle | Selon les règles de la passerelle |
| Périmètre | Série Kimi | Compte unifié multi-modèles |
| Consultation du solde | Interface et console officielles | Console de la passerelle |
| Usage | Kimi uniquement, entité claire | Multi-modèles, achat et rapprochement unifiés |
Pour un seul modèle et un circuit financier simple, la recharge officielle est la plus directe. Pour plusieurs modèles et une facture unique couvrant plusieurs fournisseurs, la passerelle simplifie la gestion. Les deux peuvent coexister : activité principale en direct, tests et expérimentations multi-modèles via la passerelle.
8. Checklist d'achat et de remboursement
- Confirmer l'entité utilisatrice, le site et le nom du compte.
- Confirmer le montant, la devise et le canal de paiement.
- Confirmer l'intitulé, le numéro fiscal, la dénomination et la base de facturation.
- Confirmer le délai d'arrivée et prévoir les jours ouvrés pour un achat de fin de mois.
- Confirmer que le niveau de limitation couvre les besoins de concurrence.
- Confirmer la mise en place des alertes de solde et du budget mensuel.
- Conserver recharges, factures et relevés pour l'audit trimestriel.
Questions fréquentes
Pourquoi le solde n'apparaît-il pas après la recharge ?
Le paiement QR code est généralement rapide ; le virement dépend de la banque et prend souvent un à cinq jours ouvrés, puis la plateforme crédite le compte. Vérifiez d'abord que l'émetteur correspond au titulaire vérifié, puis contactez la finance et le support.
Que faire si j'ai rechargé le mauvais site ?
Les soldes des sites chinois et international ne sont pas interchangeables. Identifiez le compte payeur et le bénéficiaire, puis suivez les indications du support. N'ajoutez pas de recharge sur le compte d'origine, pour éviter d'aggraver le montant.
Facture sur la recharge ou sur la consommation ?
Les deux sont possibles selon le rythme de remboursement. La facturation sur recharge convient au remboursement anticipé, mais inclut la partie non consommée ; celle sur consommation reflète le coût réel, avec une demande régulière. Confirmez la base avec la finance.
La recharge de l'API Kimi est-elle remboursable ?
L'accord de recharge et la réponse du support font foi. Les conditions varient selon l'entité et le moyen de paiement ; vérifiez avant de payer, surtout pour un gros virement d'entreprise.
Pourquoi le bon n'est-il pas déduit ?
Vérifiez son périmètre et sa validité ; certains modèles peuvent être exclus. Les bons ne comptent généralement pas dans le cumul de recharge et n'augmentent ni le niveau ni le quota de limitation.
Pour aller plus loin
Inscrivez-vous d'abord sur ZSQH AI Gateway et consultez la page de recharge pour confirmer devise, facture et modèles disponibles, puis choisissez entre connexion directe officielle et recharge unifiée via passerelle. Prix et base de facturation sont ceux de la page Tarifs des modèles.
Lectures associées :
