En octobre 2026, la plateforme ouverte Moonshot, derrière Kimi, ne propose pas de niveau gratuit sur lequel s'appuyer durablement. Un nouvel utilisateur obtient un petit crédit après vérification d'identité, et un compte sans recharge reste en Tier0, avec les limites les plus strictes. Brancher ce crédit d'essai sur la production est la méprise la plus fréquente avec ce type d'offre.

Cet article ne traite que de l'API côté plateforme ouverte, pas de la version web de Kimi ni des abonnements. La documentation a migré vers platform.kimi.com, mais le domaine d'interface en Chine reste souvent api.moonshot.cn. Les éléments ci-dessous reflètent les pages officielles d'octobre 2026.

Note : Moonshot et Kimi sont des marques de leurs titulaires. Cet article n'a aucun lien de filiale, d'agence ou de partenariat avec Moonshot AI (Yuezhianmian) ; les règles citées suivent les pages officielles.

I. Conclusion : c'est un essai, pas un niveau gratuit

Trois faits à clarifier.

Premièrement, la page tarifaire actuelle liste kimi-k3, kimi-k2.7-code, kimi-k2.6 et d'autres modèles facturés à l'usage, sans modèle gratuit. Les interfaces de fichiers (extraction de contenu, stockage de fichiers) sont gratuites pour une durée limitée, mais le contenu extrait reste facturé au token lorsqu'il est utilisé en entrée de modèle.

Deuxièmement, un utilisateur vérifié peut recevoir un crédit de 15 yuans. Sur le site chinois, un utilisateur vérifié ne peut pas l'utiliser pour appeler K3 : la page demande d'abord une recharge. La couverture des autres modèles et la date d'expiration dépendent des conditions de la page de réception.

Troisièmement, le crédit n'entre pas dans le cumul des recharges. Le niveau de débit est déterminé par ce cumul : utiliser le crédit ne fait donc pas monter de Tier. C'est ce qui explique que « quota gratuit » et « quota payant » n'offrent pas la même expérience en concurrence et en RPM.

II. Les quatre limites du Tier0

Un compte sans recharge est en Tier0. La documentation officielle des limites donne les valeurs d'entrée suivantes, susceptibles d'évoluer ; vérifiez le texte avant de tester.

Indicateur Valeur de la documentation Effet réel pour le développement
Concurrence 1 Impossible d'envoyer des requêtes en parallèle ; un appel lent bloque les suivants
RPM 3 Trois requêtes par minute ; un réessai après échec peut suffire à saturer
TPM 500 000 Une requête de document long peut en consommer une grande part
TPD 1 500 000 Plafond quotidien de tokens ; les tâches par lots l'atteignent vite

Avec un RPM de 3, la stratégie de réessai par défaut du SDK amplifie le problème. Le SDK OpenAI réessaie automatiquement deux fois : un appel échoué peut générer trois requêtes, chacune comptée dans le RPM. En Tier0, un seul 429 peut consommer le quota de toute la minute.

Les paliers payants suppriment généralement le plafond quotidien de tokens, mais les TPM, la concurrence et les RPM subsistent. Plus le niveau est élevé, plus les quotas sont larges ; les seuils exacts figurent sur la page officielle des limites. La plateforme peut aussi limiter temporairement en cas de charge élevée du cluster ; un compte jugé anormal déclenche un bridage de contrôle des risques, que la documentation indique comme non levable. L'architecture ne doit donc pas supposer que « payer supprime toute limitation ».

III. Où le quota gratuit bloque le plus souvent

Au-delà des chiffres du tableau, quatre limites sont souvent négligées.

  1. Durée de validité : le crédit a une date limite et n'est pas converti en solde à l'expiration.
  2. Périmètre des modèles : le crédit ne couvre pas forcément tous les modèles ; K3 est explicitement exclu.
  3. Site et clé : les comptes et clés de platform.kimi.com (Chine) et platform.kimi.ai (international) ne sont pas interchangeables ; un mélange renvoie 401.
  4. Solde et type d'erreur : solde insuffisant et limitation peuvent tous deux renvoyer 429, mais avec un error.type différent. exceeded_current_quota_error impose une recharge ; rate_limit_reached_error impose de ralentir ou de monter de niveau ; engine_overloaded_error relève de la capacité du service et une recharge n'y change rien.

Ne réessayez pas systématiquement sur un 429. Lisez d'abord error.type, puis décidez entre réessai, réduction de concurrence et recharge.

IV. Clauses sur les données : ne pas considérer l'essai comme confidentiel

L'accord de la plateforme (version du 31 août 2026) prévoit que l'utilisateur accorde à la plateforme un droit d'usage gratuit lui permettant d'utiliser les entrées, sorties et retours dans les limites légales pour l'amélioration du service de modèle. Le texte ne prévoit pas d'option de retrait pour les comptes personnels. La politique de confidentialité précise que les données sont stockées en Chine continentale et ne sont pas transférées à l'étranger sans consentement distinct.

Les clients entreprises peuvent demander une conservation nulle des données (ZDR). Une fois activée, le contenu des requêtes ne sert qu'à l'inférence en cours et est effacé après la réponse ; les données d'entreprise ne servent pas à l'entraînement. Mais la ZDR a des limites explicites : l'API Batch, les images ou vidéos téléversées via l'interface fichier, les Hosted Agents, les journaux de sécurité et les données opérationnelles de facturation, ainsi que les services tiers, n'entrent pas dans le périmètre. La ZDR s'active à la demande auprès du service commercial, ce n'est pas un interrupteur par défaut.

Pendant l'essai, ne placez donc pas de contrats clients, de données personnelles, de code non publié ou de données financières. Pour les données sensibles, faites examiner l'accord et les clauses ZDR par le juridique et la sécurité, sans invoquer « ce n'est qu'un test » pour sauter l'évaluation.

V. À quoi sert un accès gratuit

Dans la limite du quota, les tâches suivantes conviennent.

  • Intégration d'interface : valider l'URL de base, l'authentification, le streaming et la gestion des erreurs, et confirmer que le SDK fonctionne.
  • Évaluation sur petit échantillon : comparer invites et modèles sur 10 à 30 tâches réelles, sans viser la significativité statistique.
  • Outils internes à faible concurrence : scripts personnels, résumé ponctuel de document, brouillon de compte rendu.
  • Validation de flux documentaire long : extraction via l'interface fichier, puis test du découpage, des citations et de la sortie structurée.
  • Première mesure de latence : relever le délai du premier token et la durée totale pour décider d'une stratégie de streaming et de délais d'attente.

Le point commun : les échecs peuvent être rejoués, un humain relit les résultats, et rien ne va directement au client.

VI. Tâches à ne pas confier au quota gratuit

  • Trafic de production : la concurrence et le RPM du Tier0 ne soutiennent pas de vrais utilisateurs, et une limitation temporaire n'est pas compensée.
  • Données clients : les clauses par défaut autorisent l'usage des entrées/sorties pour l'amélioration du service ; un compte d'essai ne convient pas aux contenus confidentiels.
  • Tâches par lots : le TPD sera atteint d'abord ; l'API Batch est une capacité payante, hors périmètre ZDR.
  • Services à forte concurrence : une concurrence de 1 signifie file d'attente et latence non maîtrisée.
  • Systèmes exigeant un SLA : l'accord standard ne donne pas d'engagement de disponibilité et exclut la responsabilité en cas d'interruption de maintenance.
  • Systèmes dépendant d'anciens modèles : la série moonshot-v1 et certains anciens K2 ont été retirés ; le coût de migration doit être anticipé.

Autre risque fréquent : inscrire la clé d'essai dans le front-end ou un dépôt. Une clé exposée peut être utilisée pour consommer le quota. Gérez aussi les secrets pendant la période d'essai.

VII. De l'essai au payant : le chemin de mise à niveau

Une fois la validation réussie, la montée en charge se fait généralement en trois étapes.

  1. Recharger pour monter de niveau : le niveau de débit dépend du cumul des recharges ; après recharge, concurrence, RPM et TPM augmentent. Les paliers exacts figurent sur la page officielle des limites.
  2. Vérification entreprise et paiement par virement : pour signer un contrat, facturer ou gérer des permissions, effectuez la vérification entreprise et payez par virement ou en ligne. Les capacités de facturation, de budget et de permissions des membres diffèrent de celles d'un compte personnel.
  3. Demander des quotas supérieurs et la ZDR : en cas de pic de concurrence, d'exigence de conformité ou de SLA, préparez la consommation mensuelle, le pic de concurrence, les cas d'usage et le plan de croissance, puis négociez avec le service commercial et inscrivez les engagements au contrat ou en annexe.

Si l'équipe a besoin de changer de modèle, d'unifier la facturation ou de disposer d'un canal de secours, une passerelle IA compatible OpenAI peut être évaluée. Une couche supplémentaire ajoute une dépendance : validez aussi à faible volume lors du choix.

VIII. Une validation reproductible

Ne concluez pas « ça a l'air de fonctionner ». Déroulez les étapes suivantes avant de décider d'une recharge.

  1. Préparez 10 à 30 tâches réelles avec des exigences explicites de qualité, de format et de citation.
  2. Quantifiez l'entrée avec l'interface d'estimation de tokens de la plateforme, sans deviner au nombre de caractères.
  3. Relevez la concurrence cible, le RPM de pointe et les tokens quotidiens, et comparez-les aux limites Tier0.
  4. Désactivez les réessais automatiques du SDK et pilotez vous-même le nombre de tentatives et le retrait.
  5. Enregistrez pour chaque requête l'entrée, la sortie, la durée, error.type et le nombre de réessais.
  6. Fixez un budget de tokens de test, arrêtez-vous à l'épuisement, puis calculez le coût par tâche.
import os
import time
from openai import OpenAI, RateLimitError

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.cn/v1",
    max_retries=0,  # réessais pilotés manuellement pour éviter les 2 tentatives par défaut qui consomment le RPM
)

BUDGET = 200_000  # plafond de test défini par l'équipe, pas un quota officiel
used = 0

def ask(prompt: str) -> str:
    global used
    if used >= BUDGET:
        raise RuntimeError("Budget de test épuisé")
    try:
        resp = client.chat.completions.create(
            model="kimi-k2.6",
            messages=[{"role": "user", "content": prompt}],
            max_completion_tokens=512,
        )
    except RateLimitError as exc:
        body = exc.response.json().get("error", {})
        print("Type de 429 :", body.get("type"))  # traiter séparément limite, surcharge et solde insuffisant
        time.sleep(5)
        return ""
    used += resp.usage.total_tokens
    return resp.choices[0].message.content

Ce code n'est qu'un exemple de budget et de classification d'erreurs, pas une recommandation de limitation. Un vrai test de charge doit être conçu selon la concurrence cible et vérifier au préalable que les conditions de la plateforme l'autorisent.

Questions fréquentes

Existe-t-il une API Moonshot gratuite en permanence ?

En octobre 2026, il n'existe pas de niveau gratuit pouvant servir d'engagement durable. La plateforme offre un crédit après vérification, mais il s'agit d'un essai, avec des limites de modèles et de durée. Les nouvelles offres éventuelles font foi sur les pages officielles.

Le crédit de 15 yuans couvre-t-il tous les modèles ?

Non. Sur le site chinois, un utilisateur vérifié ne peut pas l'utiliser pour K3 ; la couverture des autres modèles dépend des conditions de la page de réception. Ne supposez pas que le crédit vaut pour toute la gamme.

Le Tier0 suffit-il pour la production ?

Non. Une concurrence de 1, 3 RPM et un plafond quotidien de tokens ne conviennent qu'à l'intégration et aux petits échantillons. La production exige une recharge et une montée de niveau, avec limitation, réessai et dégradation prévus.

Les données d'essai servent-elles à l'entraînement ?

L'accord par défaut permet à la plateforme d'utiliser entrées et sorties dans le cadre légal pour l'amélioration du service. Une entreprise peut demander la ZDR, avec des exceptions comme Batch, le téléversement de fichiers et les Hosted Agents. Faites passer les données sensibles par une évaluation de conformité.

Que se passe-t-il quand le crédit d'essai est épuisé ?

La réponse peut être un 429 ou un 403 selon l'entrée et le cas. Regardez error.type : solde insuffisant impose une recharge, limitation impose de ralentir ou de monter de niveau, surcharge de capacité impose un retrait et un réessai.

Pour aller plus loin

Si votre intégration et vos évaluations sur petit échantillon sont validées et que vous avez besoin d'appels stables, d'une facturation en yuans et d'un point d'entrée multi-modèles, vous pouvez créer un compte sur la passerelle IA ZSQH pour un test à faible montant ; modèles, tarifs et disponibilités font foi sur Tarifs et modèles.

Lectures associées :