Endpoint et alias
Le guide officiel utilise https://api.moonshot.ai/v1 et l’alias de modèle kimi-k3 avec Chat Completions.
Français
KIMI K3 API + SILLYTAVERN
Le contrat de l’API Kimi K3, sans deviner
SillyTavern peut joindre Kimi K3 avec une connexion compatible OpenAI, mais le modèle garde ses propres règles. Commencez par l’endpoint et l’alias exacts, puis vérifiez le corps, le bloc de raisonnement, le fournisseur et le code de statut.
La documentation officielle utilise https://api.moonshot.ai/v1 et kimi-k3. K3 raisonne toujours : utilisez reasoning_effort au lieu de copier un bloc thinking de K2.x.
CE QUE DISENT LES SOURCES
Compatible OpenAI ne signifie pas mêmes paramètres
La documentation officielle de Kimi est précise pour K3. Les résultats de la communauté donnent des pistes sur la lenteur, le raisonnement excessif, les quotas ou les filtres, mais ne garantissent pas le service.
Le raisonnement fait partie de la réponse
K3 garde thinking actif. En streaming, reasoning_content peut arriver séparément de content et les échanges peuvent nécessiter le message assistant complet.
Le fournisseur compte
Un frontend compatible ne rend pas les fournisseurs identiques. Vérifiez l’alias, les limites, les champs acceptés et la conservation du bloc de raisonnement.
CONTRAT DE L’API
Quatre vérifications avant de toucher à un preset
Séparez un problème d’authentification d’un problème de paramètres. Gardez la clé dans une variable d’environnement et commencez par Chat Completions.
Corps minimal
curl https://api.moonshot.ai/v1/chat/completions \
+ -H "Authorization: Bearer $MOONSHOT_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"model":"kimi-k3","reasoning_effort":"high","messages":[{"role":"user","content":"Hello"}]}'Le code montre les noms officiels. N’ajoutez pas les champs fixes de K3 simplement parce que le client OpenAI les accepte.
- 01
1. Base URL
Utilisez https://api.moonshot.ai/v1 comme base URL du client OpenAI. Un proxy peut publier une autre URL : suivez sa documentation.
- 02
2. Clé Bearer
Créez une clé dans Kimi API Platform et envoyez-la avec Authorization: Bearer. Gardez-la dans MOONSHOT_API_KEY ou la variable du fournisseur, jamais dans un preset public.
- 03
3. Alias exact
La route officielle utilise kimi-k3. Le nom visible Kimi K3 n’est pas toujours le slug de requête. Confirmez l’alias dans la liste du fournisseur.
- 04
4. Garder le tour assistant
Si la réponse contient reasoning_content, conservez le message assistant complet au tour suivant. Retirer des champs peut produire une réponse vide ou invalide.
CHAMPS DU MODÈLE
K3 utilise reasoning_effort, pas un bloc K2.x copié
L’erreur courante consiste à traiter tous les modèles Kimi comme une seule API. K3 et K2.x ont des contrôles différents et refusent certains champs.
Raisonnement de K3
Utilisez reasoning_effort au niveau supérieur avec low, high ou max. La valeur officielle par défaut est max et thinking reste actif.
thinking de K2.x
L’objet thinking appartient à K2.x. Ne le collez pas dans une requête K3, sauf si le fournisseur documente une couche de traduction.
Outils et partial mode
K3 accepte tool_choice auto, none et required. partial mode utilise un message assistant avec partial=true, séparé du template texte de SillyTavern.
Avec K3, omettez temperature, top_p, n, presence_penalty et frequency_penalty. La référence officielle les décrit comme fixes. Pour les contrôles du fournisseur, suivez sa documentation.
VÉRIFICATION DU FOURNISSEUR
La même interface peut cacher des contrats différents
Utilisez la ligne officielle pour appeler Moonshot. Dans une passerelle ou un endpoint partagé, confirmez chaque valeur dans la documentation du fournisseur.
| API officielle Moonshot | Passerelle ou fournisseur externe | |
|---|---|---|
| Base URL | https://api.moonshot.ai/v1 | Utiliser exactement l’URL du fournisseur |
| Champ du modèle | kimi-k3 | Confirmer le slug ou l’alias affiché |
| Contrôle du raisonnement | reasoning_effort: low | high | max | Vérifier si le champ est transmis ou transformé |
| Limites et accès | Niveau du compte et limites Kimi actuelles | Facturation, quota, RPM, TPM et concurrence du fournisseur |
| Historique | Conserver le message assistant complet | Vérifier la conservation de reasoning_content |
BANC D’ERREURS
Lisez le code avant de réécrire le prompt
Ces vérifications indiquent la prochaine action. Le texte exact varie selon les fournisseurs.
La clé manque, est mal formée, a expiré ou a été envoyée au mauvais hôte.
Vérifiez l’en-tête Authorization, la variable d’environnement, le fournisseur choisi et l’accès du compte. Remplacez la clé si elle a été exposée.
Le chemin ou l’alias n’est pas disponible chez ce fournisseur.
Confirmez que la base URL se termine par /v1, que le chemin est /chat/completions et que la liste contient kimi-k3 ou l’alias documenté.
La requête a atteint une limite de débit, de concurrence, de quota ou de compte.
Lisez les limites du fournisseur, réduisez les tours parallèles, raccourcissez le contexte et réessayez avec un délai. Un témoignage n’est pas une limite universelle.
Un champ n’est pas accepté, le format thinking ne correspond pas ou le tour assistant est incomplet.
Retirez thinking de K2.x et les champs fixes de K3, validez messages et renvoyez reasoning_content si nécessaire.
MOINS DE CONFIGURATION
Utilisez Kimi à côté de la page avant de brancher une API
Si vous voulez seulement poser une question sur une fiche, une wiki ou un brief, Tabbit propose un chat dans le navigateur. Il ne remplace pas SillyTavern et n’expose ni cards ni lorebooks.
01
Ouvrir le contexte
Gardez la fiche, la page de lore ou le brouillon dans un onglet. Tabbit peut référencer la page, une capture ou un fichier local.
02
Choisir Kimi-K3
Sélectionnez Kimi-K3 dans le picker actuel de Chat ou du nouvel onglet. Les images sont des exemples ; vérifiez la liste et l’accès dans l’application.
03
Questionner et comparer en lisant
Utilisez la barre latérale ou comparez les réponses dans une vue. Vous évitez de configurer un endpoint dans ce parcours et gardez les fonctions de personnage dans SillyTavern.
GARDER LA LIMITE CLAIRE
SillyTavern et Tabbit couvrent des couches différentes
Choisissez l’outil adapté à la tâche suivante. Un raccourci de chat n’est pas un moteur de cards.
| SillyTavern | Tabbit | |
|---|---|---|
| Endpoint et clé | Configurer fournisseur, clé, alias et template | Choisir un modèle intégré disponible |
| Cards et lorebooks | Flux central de SillyTavern | Page ou fichier comme contexte |
| Diagnostic | Inspecter la réponse et les extensions du fournisseur | Questionner à côté de la page sans gérer les champs API |
| Extensions et groupes | Écosystème SillyTavern | Surface produit différente |
FAQ API K3
Réponses pour le prochain échec
Quel est l’endpoint officiel de Kimi K3 ?+
Le guide officiel utilise https://api.moonshot.ai/v1 et le chemin /chat/completions. Une passerelle peut publier une autre base URL.
Quel alias saisir dans SillyTavern ?+
Pour Moonshot officiel, kimi-k3. Chez un autre fournisseur, utilisez le slug exact de sa liste actuelle.
Dois-je envoyer thinking ou reasoning_effort ?+
K3 utilise reasoning_effort avec low, high ou max et thinking est toujours actif. L’objet thinking appartient à K2.x.
Pourquoi la réponse est-elle lente, vide ou pleine de raisonnement ?+
K3 raisonne toujours. Vérifiez effort, le streaming et la conservation du message assistant complet avec reasoning_content. Les témoignages ne sont pas une garantie de service.
Pourquoi un preset OpenAI renvoie-t-il 400 ?+
Retirez les champs fixes comme temperature et le thinking de K2.x. Validez ensuite alias, messages et schéma du fournisseur.
Puis-je essayer Kimi K3 sans clé API ?+
Le sélecteur Tabbit actuel affiche Kimi-K3. Vous pouvez donc tester le parcours navigateur sans créer votre endpoint. L’accès et les quotas peuvent changer.
Gardez la profondeur des personnages dans SillyTavern. Utilisez Tabbit pour une question rapide.
Pour les cards, lorebooks et extensions, configurez SillyTavern. Pour interroger une page maintenant, ouvrez Tabbit et choisissez le modèle dans le sélecteur actuel.
Disponible sur macOS et Windows. L’accès au modèle dépend de l’édition et du forfait.