Comment vérifier le solde de mon API Kimi (Moonshot AI) ?

Dernière mise à jour : 26 septembre 2026

Connecte-toi sur platform.kimi.ai et ouvre la page fee-detail dans la console. Ou appelle GET https://api.moonshot.ai/v1/users/me/balance avec ta clé d’API. Le champ available_balance est ce que tu peux encore dépenser.

Ci-dessous : ce que signifient les trois champs de solde, ce qui se passe à zéro, pourquoi il n’existe pas de point d’accès d’utilisation, et pourquoi tu dois choisir la bonne des deux plateformes. Moonshot a déjà renommé sa plateforme ; cette page reflète sa propre documentation à la date ci-dessus.

Moonshot, Kimi et deux plateformes

Moonshot AI exploite l’API Kimi. Son site pour développeurs a déménagé : platform.moonshot.ai redirige maintenant vers platform.kimi.ai, et platform.moonshot.cn vers platform.kimi.com. Les hôtes de l’API gardent les anciens noms : api.moonshot.ai et api.moonshot.cn.

Ce sont deux plateformes distinctes, pas deux portes vers un même compte. Kimi dit aux utilisateurs hors de Chine continentale d’utiliser platform.kimi.ai. Les comptes, soldes et clés de chaque côté sont indépendants. Un solde rechargé sur une plateforme n’apparaît pas sur l’autre.

L’Open Platform est aussi à part des autres produits de Kimi. Les pages d’aide de Kimi disent clairement que l’Open Platform, Kimi Code et l’abonnement Kimi ne partagent ni clés ni soldes. Un abonnement ne se transforme pas en solde d’API, et un solde d’API ne peut pas acheter un abonnement ni un forfait Kimi Code.

Dans la console

Connecte-toi sur platform.kimi.ai et ouvre la page fee-detail (détails de facturation) dans la console. Selon les pages d’aide de Kimi, elle montre :

ton solde actuel,
l’utilisation par jour,
l’utilisation et le coût par modèle,
les dépenses passées dans le temps.

Les chiffres de facturation arrivent avec du retard, et Kimi n’indique aucun délai fixe. La dépense du jour sur cette page est donc un chiffre provisoire, pas définitif.

Avec l’API

Le point d’accès du solde est un simple GET avec ta clé d’API comme jeton bearer :

GET https://api.moonshot.ai/v1/users/me/balance
Authorization: Bearer <your API key>

Sur la plateforme chinoise, le chemin est le même et l’hôte est api.moonshot.cn. La réponse contient trois nombres :

available_balance — ce que tu peux encore dépenser : espèces et bons additionnés. C’est le chiffre qui décide si tes appels passent.
voucher_balance — le crédit des bons. Il ne peut pas descendre sous zéro.
cash_balance — l’argent que tu as versé. Il peut descendre sous zéro ; un chiffre négatif signifie que tu dois de l’argent à Moonshot.

La devise dépend de la plateforme. La documentation internationale donne les trois champs en dollars américains ; celle de la Chine les donne en yuans. La réponse elle-même ne porte aucun champ de devise, donc ton code doit savoir de quelle plateforme vient la clé.

Les bons des campagnes de recharge arrivent aussi dans voucher_balance. Les pages d’aide de Kimi t’orientent vers ce point d’accès pour vérifier si l’un d’eux est arrivé.

Ce qui se passe à zéro

Dès que available_balance est à zéro ou en dessous, Kimi rejette les appels à ses modèles avec l’erreur exceeded_current_quota_error. Tu dois alors recharger, ou vérifier si ton bon est encore valable.

La même erreur apparaît aussi quand le compte est en retard de paiement ou qu’un bon est épuisé. Kimi la cite parmi les causes d’une réponse 429, à côté des limites de débit et de la surcharge. Une recharge règle celle-ci. Pour la surcharge, dit Kimi, ajouter de l’argent n’aide pas.

Kimi propose deux freins avant d’atteindre zéro :

Alertes de solde. Kimi conseille de les activer ; la plateforme te prévient alors quand le solde passe sous un montant que tu fixes.
Un budget quotidien par projet, défini dans les paramètres du projet de la console. Dès qu’un projet l’atteint, Kimi rejette tous les appels d’API de ce projet. Comme la facturation a du retard, le plafond peut mettre un moment à agir.

Pas de point d’accès pour l’utilisation

L’API indique le solde et rien d’autre. L’utilisation quotidienne, le coût par modèle et les dépenses passées ne figurent que sur la page fee-detail de la console.

Si tu veux ton propre relevé, une façon consiste à lire le solde à heures fixes et à noter de combien il baisse. Cela marche tant que tu ne recharges pas entre-temps, et cela ne distingue ni les modèles ni les projets. Comment les autres API d’IA gèrent les coûts, et où se situe Kimi parmi elles : voir Les coûts d’API d’IA en un coup d’œil.

Quand la clé renvoie 401

Très probablement, la clé appartient à l’autre plateforme. Les clés de platform.kimi.ai ne fonctionnent qu’avec api.moonshot.ai, celles de platform.kimi.com qu’avec api.moonshot.cn. Envoyée au mauvais hôte, une clé valide renvoie 401.

La propre liste de contrôle de Kimi ajoute deux autres causes : une clé de Kimi Code au lieu de l’Open Platform, et d’anciens réglages dans des outils locaux qui pointent encore vers une autre clé ou un autre hôte. Vérifie-les avant de créer une nouvelle clé.

Dans AI Cockpit

La carte Kimi K3 se trouve dans la barre des menus du Mac, dans l’app sur iPhone et iPad, et dans la zone de notification de Windows. Sur Apple Watch (via l’app iPhone), Kimi apparaît comme une ligne avec le solde disponible. Tu saisis ta clé d’API dans les Réglages et choisis la plateforme, internationale ou Chine ; la carte appelle alors le point d’accès du solde décrit plus haut.

Le solde disponible, avec les parts des bons et des espèces en dessous.
Un badge « actif » ou « vide », et une alerte dans l’en-tête de la carte dès que le solde disponible est à zéro ou en dessous.
Une remarque sur la carte indiquant que Kimi ne donne aucune donnée d’utilisation par l’API.
Sur le Mac uniquement : si tu saisis aussi un jeton d’accès pour le forfait Kimi Code, la carte affiche le quota de session de ce forfait, avec la part utilisée et son heure de réinitialisation. Par défaut, elle passe en couleur d’alerte à 75 et 90 %. Tu peux aussi la placer dans la barre des menus.

Ce qu’elle ne fait pas : recharger, afficher la dépense quotidienne ou mensuelle, ni définir des alertes et des budgets côté Kimi. La carte indique toujours les montants en dollars américains. Sur la plateforme chinoise, Moonshot compte en yuans, donc lis-y le chiffre comme des yuans.

Comment AI Cockpit lit les coûts des autres API : voir Les coûts d’API d’IA en un coup d’œil. Des réponses courtes à d’autres questions se trouvent sur la page FAQ.