| À retenir |
|---|
Authorization: Bearer ...base_url = https://api.moonshot.ai/v1/models avant le premier vrai appel. L’endpoint List Models sert à lister les modèles disponibles et renvoie un champ id ; c’est cette valeur qu’il faut transmettre au paramètre model. model et messages. La documentation Chat API illustre cette structure, et l’overview précise le chemin /chat/completions. Dans cet exemple, base_url reprend la valeur indiquée par Kimi pour l’usage du SDK OpenAI. La variable
KIMI_MODEL_ID doit venir du champ id renvoyé par GET /models
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ['MOONSHOT_API_KEY'],
base_url='https://api.moonshot.ai/v1',
)
response = client.chat.completions.create(
model=os.environ['KIMI_MODEL_ID'],
messages=[
{'role': 'user', 'content': 'Bonjour, présente-toi en une phrase.'}
],
)
print(response)Commencez par lister les modèles accessibles depuis votre compte Moonshot : l’endpoint renvoie les modèles avec leur champ id.
curl -sS https://api.moonshot.ai/v1/models -H "Authorization: Bearer $MOONSHOT_API_KEY"Une fois le bon id copié, envoyez la requête à Chat Completions. Le chemin complet /chat/completions et la structure model + messages sont documentés par Kimi.
curl -sS https://api.moonshot.ai/v1/chat/completions -H "Authorization: Bearer $MOONSHOT_API_KEY" -H "Content-Type: application/json" -d '{"model":"PASTE_MODEL_ID_FROM_MODELS","messages":[{"role":"user","content":"Rédige une courte présentation de Kimi K2.6."}]}'Si l’appel échoue côté facturation, ou si vous voulez tester le compte avant de l’intégrer dans une application, Kimi fournit l’endpoint /users/me/balance avec authentification Bearer.
curl -sS https://api.moonshot.ai/v1/users/me/balance -H "Authorization: Bearer $MOONSHOT_API_KEY"Certaines plateformes qui rediffusent Kimi K2.6 utilisent leurs propres identifiants de modèle. AIMLAPI documente un appel vers https://api.aimlapi.com/v1/chat/completions avec model défini à moonshot/kimi-k2-6. OpenRouter, de son côté, affiche
moonshotai/kimi-k2.6 sur sa page API.
Ces valeurs ne sont à utiliser que si vous passez par la passerelle correspondante. Si vous appelez directement https://api.moonshot.ai/v1/chat/completions, le choix le moins risqué reste d’interroger GET https://api.moonshot.ai/v1/modelsid retourné pour votre compte.
Le flux le plus fiable est simple : récupérer une clé API, configurer le SDK OpenAI avec https://api.moonshot.ai/v1, vérifier l’identifiant exact de Kimi K2.6 via /models, puis appeler /chat/completions avec model et messages. Cette approche suit la compatibilité OpenAI décrite par Kimi et évite l’erreur classique : copier dans Moonshot un model ID prévu pour AIMLAPI ou OpenRouter.