L'API Moonshot est l'interface de la famille de modèles Kimi. Elle met l'accent sur le contexte long, la compréhension du chinois et le rapport qualité-prix. On la rencontre souvent dans la lecture de documents longs, les bases de connaissances, le service client et la génération de contenu.
Cet article présente l'obtention d'une clé, les modes d'appel et les points à vérifier avant d'intégrer l'API Moonshot.
Remarque : Moonshot et Kimi sont des marques de leurs détenteurs respectifs. Les exemples ci-dessous correspondent aux versions courantes d'octobre 2026 ; les noms de modèles et les tarifs applicables figurent sur la page Tarifs des modèles.
1. À quoi sert l'API Moonshot
- Synthèse de documents longs, lecture de contrats et de rapports.
- Questions-réponses et service client en chinois.
- Bases de connaissances et RAG.
- Création et réécriture de contenu.
- Explication de code.
La longueur de contexte est l'argument principal de la famille Kimi, mais elle ne dispense pas de préparer les documents. Un contexte plus long coûte plus cher et peut diluer les informations utiles si le texte envoyé contient trop de bruit.
2. Obtenir une clé
Plateforme Moonshot
Créez un compte sur la plateforme ouverte Moonshot, générez une clé et rechargez le solde.
Passerelle ZSQH AI Gateway
- Créez un compte sur ZSQH AI Gateway.
- Créez une clé et fixez un quota.
- Rechargez le solde.
- Appelez l'API avec le SDK OpenAI.
Une passerelle est utile lorsque vous devez combiner Kimi avec d'autres modèles dans le même produit, ou lorsque le paiement et la facturation doivent être centralisés.
3. URL de base
L'URL de base de la plateforme Moonshot est généralement :
https://api.moonshot.cn/v1
Celle de la passerelle est :
https://ai.zhongshangqihang.com/v1
Utilisez l'adresse correspondant à la clé. Les clés ne sont pas interchangeables entre les deux entrées, et un mélange provoque généralement une erreur 401.
4. Appel en Python
from openai import OpenAI
client = OpenAI(
api_key="sk-votre-cle",
base_url="https://ai.zhongshangqihang.com/v1",
)
resp = client.chat.completions.create(
model="moonshot-v1-8k",
messages=[{"role": "user", "content": "Résumez ce texte en trois phrases : ..."}],
)
print(resp.choices[0].message.content)
Le nom du modèle figure sur la page de tarifs. Les modèles à contexte long sont généralement plus chers ; choisissez la fenêtre de contexte en fonction de la taille réelle des documents, pas par précaution.
5. Bien utiliser les textes longs
- Segmentez ou résumez d'abord ; ne remplissez pas toute la fenêtre de contexte dès le premier appel.
- Conservez les sources citées pour faciliter la vérification.
- Les requêtes à contexte long sont plus lentes et plus coûteuses : fixez un délai d'attente adapté.
- Pour une sortie structurée, utilisez le mode JSON ou les appels d'outils lorsqu'ils sont pris en charge.
- Faites une seconde vérification sur les contenus importants.
Pour un contrat ou un rapport, il est souvent plus efficace d'envoyer d'abord la table des matières et les sections pertinentes, puis d'élargir si nécessaire. Cela réduit le coût et améliore la précision.
6. Erreurs courantes
| Erreur | Cause | Traitement |
|---|---|---|
| 401 | Clé et adresse non associées | Vérifiez la clé et l'URL de base |
| 404 | Nom de modèle ou chemin incorrect | Consultez la page de tarifs et confirmez /v1 |
| 429 | Limitation de débit | Réduisez la concurrence et réessayez |
| Contexte dépassé | Entrée trop longue | Segmentez ou résumez |
| Solde insuffisant | Compte non rechargé | Rechargez le solde |
7. Maîtrise des coûts
- Le contexte long constitue le principal poste de coût : résumez avant de poser la question.
- Pour les tâches simples, utilisez un modèle à contexte court.
- Traitez les lots en asynchrone.
- Surveillez les nouvelles tentatives et les requêtes en échec.
Une bonne pratique consiste à journaliser le nombre de tokens par requête et par fonctionnalité. Vous identifiez ainsi rapidement les flux qui consomment le plus, souvent ceux où un document entier est renvoyé à chaque tour de conversation.
Questions fréquentes
L'API Moonshot est-elle identique à la version web de Kimi ?
Non. La version web est un produit destiné aux utilisateurs ; l'API est une interface pour les programmes, avec une facturation et des paramètres différents.
Le SDK OpenAI est-il pris en charge ?
Elle est généralement compatible avec Chat Completions d'OpenAI. Le niveau exact de prise en charge des paramètres dépend de l'éditeur et de la passerelle.
L'accès est-il stable depuis la Chine ?
Moonshot est une plateforme chinoise, généralement plus stable depuis le pays que les modèles hébergés à l'étranger. Le résultat dépend de votre réseau et de votre région.
Pour aller plus loin
Si vous avez besoin d'une entrée unifiée ou de changer de modèle facilement, vous pouvez créer un compte ZSQH AI Gateway et tester d'abord un scénario de document long à faible volume. Les modèles et les tarifs applicables figurent sur la page Tarifs des modèles.
Articles liés :
