kimiapikey.comGuide
Utilisez une clé API style Kimi dans Cursor : Guide d'installation
Cursor peut communiquer avec n'importe quel endpoint compatible OpenAI ; sa connexion à cette API nécessite quatre champs et environ deux minutes. Ce guide couvre les valeurs exactes, un test qui prouve que la clé fonctionne, et les erreurs que vous êtes le plus susceptible de rencontrer.
Mis à jour le

Points clés
- Cursor nécessite trois valeurs : votre clé, l'URL de base https://api.kimiapikey.com/v1 et le nom du modèle
uncensored. - Testez d'abord la clé avec curl, afin qu'un problème côté Cursor soit facile à distinguer d'un problème côté API.
- Les modifications de type agent envoient des prompts longs, alors surveillez les tokens d'entrée : 0,15 $ par 1 M en entrée, 0,50 $ par 1 M en sortie.
- La clé d'essai permet 2 requêtes simultanées, ce que l'agent de Cursor peut dépasser. Une clé complète en permet 8.
La réponse courte
Si vous cherchez comment utiliser la clé API kimi dans cursor, la première chose à savoir est qu'une clé délivrée par un autre fournisseur ne fonctionne qu'avec l'endpoint de ce fournisseur. La clé de ce site fonctionne avec l'endpoint de ce site, et Cursor l'accepte car l'endpoint utilise le format OpenAI de chat completions. Vous collez la clé, pointez Cursor vers une autre URL de base, et ajoutez un seul nom de modèle personnalisé.
L'ensemble de la configuration dans l'ordre :
- Créez un compte et copiez votre clé depuis la page Clé API.
- Ouvrez Cursor, allez dans Paramètres, puis Modèles.
- Collez la clé dans le champ Clé API OpenAI.
- Activez le remplacement de l'URL de base et saisissez
https://api.kimiapikey.com/v1. - Ajoutez un modèle personnalisé nommé
uncensoredet sélectionnez-le dans le chat.
Le reste de cet article explique chaque étape, vous donne un moyen de tester la connexion en dehors de l'éditeur, et liste ce qui pose généralement des problèmes.
Ce que cette clé est et n'est pas
Ce site vend l'accès à un seul modèle à poids ouverts, exécuté par un fournisseur indépendant et ajusté pour répondre sans refus de contenu pour une utilisation adulte légale. Ce n'est pas l'API officielle de Moonshot, Kimi ou tout autre fournisseur, et ce n'est pas un routeur qui transmet votre requête au modèle d'un tiers. Le nom du site reflète ce que les gens recherchent, et non qui gère le service. Si vous détenez déjà une clé d'un autre fournisseur, continuez à l'utiliser avec l'endpoint de ce fournisseur. Les deux clés ne sont pas interchangeables.
Ce que vous obtenez est une API standard style OpenAI : POST /v1/chat/completions et GET /v1/models, une authentification par jeton Bearer, une fenêtre de contexte de 100 000 tokens, le streaming, l'appel de fonctions et le mode JSON. Ce n'est que du texte. Il n'y a pas de génération d'images, pas d'embeddings et pas de fine-tuning, ce qui est important dans un éditeur car les fonctionnalités de Cursor qui en dépendent n'utiliseront pas cet endpoint. L'explication de la clé API Kimi entre plus dans les détails sur le nommage et les alternatives.
Pour le codage, « uncensored » a une signification pratique. Le modèle ne s'arrêtera pas en plein milieu d'une tâche parce qu'un nom de variable ou un jeu de test semble sensible. Les outils de sécurité pour vos systèmes, les analyseurs de logs remplis de chaînes complexes, les scrapers, les générateurs de fiction et les ensembles de tests de modération sont des cas de figure qui provoquent des refus ailleurs. La limite stricte reste en place : aucun contenu sexuel impliquant des mineurs, jamais.
Configuration étape par étape dans Cursor
1. Obtenez la clé et le crédit d'essai
Inscrivez-vous avec Google, ou avec un e-mail et un mot de passe. Sur la page Clé API, vous pouvez réclamer 0,50 $ de crédit d'essai en un clic. Aucune carte n'est nécessaire, cela dure 7 jours et c'est une fois par personne. Cela suffit pour quelques centaines de requêtes de chat normales, afin que vous puissiez terminer tout ce guide avant de payer quoi que ce soit.
2. Ouvrez les paramètres du modèle
Dans Cursor, ouvrez Paramètres et trouvez la section Modèles. Les libellés du menu changent entre les versions ; cherchez un champ nommé pour une clé API OpenAI et un bouton ou un champ nommé pour remplacer l'URL de base OpenAI. Ce sont les deux paramètres qui comptent.
3. Remplissez les trois valeurs
| Champ Cursor | Valeur |
|---|---|
| Clé API OpenAI | Votre clé depuis le tableau de bord |
| Remplacer l'URL de base OpenAI | https://api.kimiapikey.com/v1 |
| Nom du modèle personnalisé | uncensored |
Saisissez l'URL de base exactement comme indiqué. Elle se termine par /v1, sans barre oblique finale et sans /chat/completions, car le client ajoute le chemin lui-même. Une URL collée avec le chemin complet produit une erreur 404, et le message d'erreur dit rarement pourquoi.
4. Sélectionnez le modèle et envoyez un message
Ouvrez le panneau de chat, choisissez uncensored dans la liste des modèles, et demandez quelque chose de petit, comme « écrivez une fonction qui analyse les dates ISO ». Si une réponse s'affiche en streaming, vous avez terminé. Si Cursor affiche une erreur, ne modifiez pas les paramètres au hasard. Passez à la section suivante et testez l'endpoint directement.
5. Connaissez l'effet secondaire du remplacement
Le remplacement de l'URL de base s'applique généralement à tous les modèles style OpenAI que vous utilisez dans Cursor, pas seulement au personnalisé. Si vous revenez à un modèle OpenAI standard plus tard, désactivez d'abord le remplacement, sinon votre requête ira vers cet endpoint avec un nom de modèle qu'il ne sert pas.
Testez la clé avant d'accuser l'éditeur
Deux minutes avec un terminal économisent une heure de devinettes. Cette requête fait ce que fait Cursor : elle envoie une complétion de chat avec un jeton Bearer.
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the word ready."}],
"max_tokens": 20
}'
Un corps JSON avec un tableau choices signifie que la clé, l'URL et le nom du modèle sont tous corrects. Vérifiez aussi les en-têtes de réponse. X-Balance-USD affiche votre crédit restant et X-Request-Id vaut la peine d'être conservé si vous devez jamais tracer une requête.
La même vérification en Python avec le SDK OpenAI officiel :
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ready."}],
max_tokens=20,
)
print(resp.choices[0].message.content)
Vous pouvez aussi lister les modèles avec GET /v1/models. Cursor et des clients similaires l'appellent parfois lorsque vous appuyez sur un bouton de vérification ; un appel models fonctionnel est donc un bon signe. Si curl fonctionne et que Cursor non, le problème vient des paramètres de l'éditeur, et le tableau des erreurs ci-dessous couvre les cas habituels.
Ce qui change lorsque le modèle écrit du code dans votre éditeur
Le chat dans un panneau latéral est peu coûteux. Une courte question avec quelques centaines de tokens de contexte coûte une fraction de centime. Les fonctionnalités de l'éditeur qui attachent des fichiers, des résultats de recherche et l'historique des conversations coûtent plus cher car chaque requête transporte tout à nouveau. Le modèle dispose d'une fenêtre de 100 000 tokens partagée entre le prompt et la réponse, et Cursor n'hésitera pas à en remplir une grande partie si vous attachez un grand dossier.
Voici un calcul réel. Supposons qu'une requête transporte 40 000 tokens d'entrée et que le modèle écrive 1 500 tokens en sortie :
- Entrée : 40 000 / 1 000 000 x $0,15 = $0,006
- Sortie : 1 500 / 1 000 000 x $0,50 = $0,00075
- Total : $0,00675 par requête, donc 100 requêtes de ce type coûtent $0,675
C'est bien en dessous d'un dollar pour un après-midi chargé, mais le côté entrée domine ; l'habitude qui fait économiser est donc de joindre moins de fichiers, et non de poser des questions plus courtes. Commencez un nouveau chat lorsque le sujet change, car l'ancien historique est payé à nouveau à chaque tour.
L'appel de fonctions est pris en charge par l'API, ce sur quoi reposent les fonctionnalités d'éditeur de type agent. Le modèle décide d'appeler un outil, votre client l'exécute et renvoie le résultat sous forme de message role: "tool". La capacité de n'importe quel modèle à piloter un agent multi-étapes dépend du modèle ; testez-le sur une petite tâche avant de lui confier une refonte. Un seul modèle à poids ouverts derrière l'API signifie que vous obtenez un seul comportement, pas un menu à choisir.
Les fonctionnalités de Cursor qui s'exécutent sur les modèles propres à Cursor, comme sa complétion par onglet, ne sont généralement pas modifiées par une clé personnalisée. Consultez la documentation actuelle de Cursor pour savoir quelles fonctionnalités acceptent un endpoint OpenAI personnalisé, car cette liste change entre les versions.
Erreurs courantes et comment les corriger
| Symptôme | Cause probable | Correction |
|---|---|---|
| 404 ou « non trouvé » | L'URL de base inclut le chemin de l'endpoint, ou manque /v1 | Utilisez exactement https://api.kimiapikey.com/v1 |
| 401 non autorisé | Espace supplémentaire ou saut de ligne dans la clé collée, ou clé obsolète | Recopiez la clé depuis le tableau de bord et collez-la à nouveau |
| Modèle non trouvé | Nom de modèle tapé différemment | Utilisez uncensored, en minuscules, rien d'autre |
429 avec le code concurrency | Trop de requêtes simultanées pour votre clé | Attendez que les requêtes en cours se terminent, ou utilisez une clé complète (8 concurrentes) |
429 avec le code rate_limited | Plus que l'allocation par minute | Ralentissez ; les clés d'essai permettent 60 requêtes par minute, les clés complètes 300 |
429 avec un en-tête Retry-After: 5 | Surcharge temporaire | Réessayez après cinq secondes |
| Le bouton de vérification échoue, curl fonctionne | L'éditeur teste avec un nom de modèle qu'il connaît | Ignorez l'étape de vérification et envoyez un vrai message de chat |
L'erreur de concurrence mérite une note car elle surprend les utilisateurs de la clé d'essai. L'essai permet 2 requêtes simultanées, et un agent qui lance plusieurs opérations en parallèle peut dépasser cette limite sans que vous fassiez quoi que ce soit. Une réponse en streaming occupe également son slot jusqu'à la fin du flux, donc une longue réponse maintient un slot occupé tout le temps. Une clé complète permet 8 requêtes simultanées et 300 requêtes par minute, ce qui est confortable pour un développeur.
Les requêtes échouées et refusées ne sont pas facturées, donc réessayer après une erreur ne coûte rien de plus. Vous pouvez lire les limites complètes sur la page de documentation.
Payer une fois que le crédit d'essai est épuisé
Il n'y a pas d'abonnement. Vous rechargez votre crédit prépayé avec n'importe quel montant entier de $20 à $500, et les requêtes le consomment à $0,15 par 1 M de tokens d'entrée et $0,50 par 1 M de tokens de sortie. Le crédit n'expire jamais, donc un mois sans coder ne coûte rien. Les recharges de $50 ou plus comportent un bonus : +5 % à partir de $50, +10 % à partir de $100 et +15 % à partir de $200. Vous pouvez payer avec de la crypto (USDT sur TRC20, USDC sur Base). Vous ne pouvez pas payer par carte. La page de tarification regroupe les chiffres actuels en un seul endroit.
En utilisant la requête de 40 000 tokens d'entrée et 1 500 tokens de sortie mentionnée plus haut, une recharge de 20 $ couvre environ 2 960 requêtes de ce type (20 $ / 0,00675 $). La plupart des requêtes de l'éditeur sont plus petites, donc le chiffre réel est plus élevé. Vos prompts ne sont pas utilisés pour l'entraînement, ce qui est important lorsque le code que vous collez appartient à un client.
Une fois la configuration terminée, une première tâche raisonnable est une petite tâche que vous pouvez examiner rapidement : un test unitaire pour une fonction existante, une expression régulière avec un long commentaire, ou la réécriture d'un fichier bruyant. Si les résultats conviennent à votre flux de travail, ajoutez du crédit. Sinon, vous n'avez dépensé que quelques centimes de crédit d'essai pour le découvrir.
Plus de guides
- Tarification de la clé API Kimi : quel est le coût de cette alternative
- Intégration de la clé API Kimi avec les SDK OpenAI et LangChain
- Clé API Kimi : comment cela fonctionne et quelles sont les alternatives
Questions fréquemment posées
Le modèle est-il le même que le Kimi officiel de Moonshot ?
Non, nous hébergeons un modèle à poids ouverts qui est ajusté pour être sans censure. Il ne s'agit pas de GPT, Claude, Gemini, Grok, DeepSeek ou de tout autre modèle d'un autre fournisseur. C'est un modèle distinct exécuté sur nos propres serveurs.
Entraînez-vous sur mes données ?
Non. Vos prompts et vos complétions ne sont pas utilisés pour l'entraînement. Nous valorisons la confidentialité et la transparence, vos données restent donc les vôtres.
Quelles sont les limites de débit ?
Vous êtes limité à 300 requêtes par minute par clé. La taille maximale du corps de la requête est de 8 MB. Ces limites sont conçues pour garantir des performances stables pour tous les utilisateurs.
Quelle est la politique en matière de contenu ?
Le modèle est sans censure concernant les sujets pour adultes, controversés et créatifs. Cependant, nous bloquons le contenu sexuel impliquant des mineurs. Il s'agit d'une limite stricte qui s'applique toujours, quel que soit votre niveau d'abonnement.
Questions et réponses
Puis-je mettre une clé Moonshot ou Kimi dans Cursor avec cette URL de base ?
Non. Une clé ne fonctionne qu'avec l'endpoint du fournisseur qui l'a émise. Utilisez la clé de votre tableau de bord ici, ou conservez l'autre clé avec l'URL de son propre fournisseur.
Quel nom de modèle dois-je entrer dans Cursor ?
Entrez uncensored, en minuscules. C'est le seul ID de modèle que cette API fournit, et un nom différent renvoie une erreur modèle introuvable.
Fonctionne-t-il avec le mode agent de Cursor ?
L'API prend en charge l'appel de fonctions, dont les fonctionnalités d'agent ont besoin. La fiabilité avec laquelle le modèle accomplit des tâches longues et multi-étapes varie, donc testez-le sur une petite tâche avant une grande.
Pourquoi obtiens-je une erreur 429 sur la clé d'essai ?
La clé d'essai permet 2 requêtes simultanées et 60 par minute. Une clé complète permet 8 simultanées et 300 par minute, et un en-tête Retry-After: 5 signifie une surcharge courte que vous pouvez réessayer.
Mon code est-il utilisé pour l'entraînement ?
Non. Les prompts envoyés à l'API ne sont pas utilisés pour l'entraînement.
Votre clé n'est qu'à un formulaire d'ici
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.