Une API pour tousGuide d’utilisation
Site web ↗
Guide d’utilisationConfigurer un outil

Kimi Code

Kimi Code est l’agent ; la configuration du fournisseur détermine le modèle. Ce guide suit le CLI actuel.

Préparez ces trois informations

L’application étant déjà installée, ouvrez Libre-service sur ce site et connectez-vous. Créez ou consultez votre clé, copiez l’adresse API affichée et un identifiant exact dans Modèles et tarifs. N’utilisez ni la page d’accueil, ni votre mot de passe, ni un nom commercial de modèle. Vérifiez le solde et le quota de la clé.

API_HOST, YOUR_API_KEY et YOUR_MODEL_ID sont des valeurs fictives : remplacez chacune avant utilisation. Suivez les indications pour /v1 ; n’ajoutez ni /chat/completions ni /responses. Les exemples ne se connectent pas automatiquement et ne contiennent pas votre clé.

1. Vérifier version et emplacement

Exécutez kimi --version. Le fichier actuel est ~/.kimi-code/config.toml, ou %USERPROFILE%\.kimi-code\config.toml sous Windows. D’anciennes versions utilisent parfois ~/.kimi : consultez leur documentation sans modifier les deux.

2. Ajouter fournisseur et modèle

Fusionnez l’exemple. provider = "my_api" doit correspondre à [providers.my_api]. my-model est un alias local ; model est l’identifiant réel. Le contexte 32768 est un exemple, à adapter aux limites confirmées.

Schéma des champs · pas une capture d’écran
type
openai / openai_responses
base_url
https://API_HOST/v1
model
YOUR_MODEL_ID
api_key_env
MY_API_KEY
Exemple de configuration

Conservez une copie du fichier actuel. Modifiez les entrées existantes sans les dupliquer et gardez les autres réglages. Ne partagez aucun fichier ou capture contenant une vraie clé.

default_model = "my-model"

[providers.my_api]
type = "openai"
base_url = "https://API_HOST/v1"
api_key_env = "MY_API_KEY"

[models.my-model]
provider = "my_api"
model = "YOUR_MODEL_ID"
max_context_size = 32768

3. Définir la clé et sélectionner

api_key_env = "MY_API_KEY" lit explicitement cette variable. Définissez-la, lancez kimi et choisissez my-model avec /model. /login connecte au service officiel, pas à notre plateforme.

Si la configuration utilise MY_API_KEY, définissez cette variable dans le terminal qui lancera l’outil. Saisissez votre clé uniquement sur votre ordinateur. Elle reste définie jusqu’à la fermeture du terminal.

Terminal macOS / Linux
export MY_API_KEY="YOUR_API_KEY"
kimi
Windows PowerShell
$env:MY_API_KEY = "YOUR_API_KEY"
kimi

4. Choisir le format

type = "openai" utilise Chat Completions. Choisissez "openai_responses" uniquement après confirmation de cette connexion pour votre modèle. Les deux exemples gardent /v1.

5. Déclarer les niveaux réels

Les modèles reconnus reçoivent généralement leurs capacités automatiquement. Pour un alias inconnu, ajoutez capabilities = ["tool_use", "thinking"] sous [models.my-model] seulement si elles sont disponibles. Définissez support_efforts et default_effort selon le modèle : pour low/high, utilisez support_efforts = ["low", "high"] et default_effort = "low". Cette déclaration ne crée aucune capacité.

Après confirmation de low pour ce modèle, ajoutez la section indépendante [thinking] pour le sélectionner. Remplacez effort par un autre niveau déclaré au besoin. Ce réglage global prime sur default_effort. Enregistrez, lancez /reload dans une session inactive, puis testez un message.

[thinking]
enabled = true
effort = "low"

Test 1 : recevoir une réponse

Créez un dossier de test vide, choisissez-le comme espace de travail et ouvrez une nouvelle conversation. Vérifiez le fournisseur et le modèle, puis envoyez le message ci-dessous. Une réponse sans erreur confirme la connexion de base, pas toutes les fonctions. Les tests entraînent une consommation API normale.

Réponds uniquement : Connexion réussie.

Résultat attendu : « Connexion réussie ». Si un écran de connexion, une erreur ou un chargement sans fin apparaît, consultez les vérifications avant de réessayer.

Test 2 : lire un vrai fichier

Dans ce dossier, créez hello.txt avec un éditeur de texte et écrivez « API connection test 27 ». Enregistrez, puis envoyez la demande ci-dessous. Autorisez uniquement la lecture de ce dossier si l’outil le demande.

Utilise l’outil de lecture pour ouvrir hello.txt dans l’espace de travail actuel et donne son contenu. Ne modifie aucun fichier.

Résultat attendu : une trace d’exécution lisant hello.txt, puis une réponse contenant API connection test 27. Une réponse seule ne prouve pas l’appel d’outil. Vous pouvez ensuite supprimer le dossier de test.

Vérifier selon le symptôme

401 / Invalid API key

Vérifiez que l’adresse et la clé complète correspondent au même service et que la clé est active. N’envoyez jamais une clé complète au support.

404 / model not found

Vérifiez /v1, l’identifiant exact et le format. Un modèle répertorié ne prend pas nécessairement tous les formats en charge.

429 / quota / balance

Vérifiez solde, quota et fréquence selon l’erreur. Augmenter le raisonnement ne rétablit pas le quota.

La conversation fonctionne, pas les fichiers

Vérifiez les outils du modèle, les autorisations du dossier et l’erreur d’exécution.

Aucun niveau de raisonnement

Vérifiez les capacités déclarées, le modèle et la version. Le raisonnement n’est pas toujours réglable.

Références officielles et portée

Configuration vérifiée le 2026-11-08. Les menus peuvent évoluer ; consultez ces références officielles. Utilisez les informations de connexion actuelles de notre plateforme.