S’agit-il de la clé API officielle de Cursor ?

Non. Il s’agit d’une API hébergée indépendante avec ses propres clés. Elle n’est pas fabriquée par ni connectée au fournisseur de Cursor, et sa clé ne fonctionne qu’avec l’URL de base de ce service.

Où trouver le paramètre d’URL de base dans Cursor ?

Recherchez dans Paramètres sous Modèles la section clé API OpenAI et une option pour remplacer l’URL de base. Les libellés varient selon les versions, alors recherchez « base URL » dans les paramètres.

Puis-je conserver mon abonnement existant et ajouter cette clé ?

En général, oui. Une clé personnalisée modifie uniquement l’endroit où les requêtes de chat sont envoyées lorsque vous sélectionnez le modèle personnalisé. Votre compte et votre plan sont gérés séparément par le fournisseur de l’éditeur.

Que se passe-t-il si je perds ou divulgue la clé ?

Générez-en une nouvelle sur la page clé API. L’ancienne clé cesse immédiatement de fonctionner. Les comptes qui ont rechargé leur crédit peuvent conserver jusqu’à 5 clés, les étiqueter et révoquer n’importe laquelle.

Clé API Cursor AI : Où placer une clé personnalisée

La réponse courte

Les éditeurs de la famille Cursor nécessitent trois valeurs pour communiquer avec un fournisseur personnalisé : une URL de base, une clé API et un nom de modèle. Pour ce service, ils sont :

URL de base : https://api.cursoraiapikey.com/v1
Clé API : la clé de la page Clé API
Nom du modèle : uncensored

Ouvrez les paramètres de l'éditeur et trouvez la section modèle. Cursor propose un champ pour une clé API OpenAI et une option pour remplacer l'URL de base OpenAI, mais les libellés du menu changent selon les versions, recherchez donc « base URL » dans les paramètres si vous ne les repérez pas. Collez l'URL et la clé, ajoutez un modèle personnalisé nommé uncensored, puis utilisez le bouton de vérification si votre version en dispose.

Ce service est indépendant de Cursor. Il s'agit d'une API hébergée distincte et il ne remplace pas le compte ou le plan propre à l'éditeur. Vous pointez uniquement le chat de l'éditeur vers un serveur compatible OpenAI différent.

Deux types de clés, deux emplacements différents

Les gens utilisent le même mot pour deux choses sans rapport, et les confondre est la raison la plus fréquente d'un échec de configuration.

La connexion au compte

L'éditeur possède sa propre connexion. Cela vous identifie auprès du fournisseur de l'éditeur et n'a rien à voir avec un fournisseur de modèle. Vous ne collez pas une clé de fournisseur sur l'écran de connexion.

La clé du fournisseur

Il s'agit d'une chaîne secrète délivrée par une entreprise qui gère un modèle. Vous la collez dans les paramètres du modèle avec une URL de base, et l'éditeur l'envoie dans un en-tête Authorization: Bearer avec chaque requête. Une clé de ce service ne fonctionne qu'avec l'URL de base de ce service, et une clé d'un autre fournisseur ne fonctionnera pas ici.

Si vous êtes ici pour trouver un moyen d'obtenir gratuitement la clé propre de l'éditeur, ce n'est pas ça. Si vous souhaitez un modèle de texte bon marché derrière le panneau de chat de l'éditeur, lisez la suite. Le même schéma fonctionne pour tout éditeur acceptant un endpoint compatible OpenAI, et l'article sur le remplacement d'une clé Claude couvre le cas parallèle pour les configurations de style Anthropic.

Tester l'endpoint avant de toucher à l'éditeur

Un test de deux minutes en dehors de l'éditeur vous indique si le problème vient de la clé ou de l'éditeur. Créez un compte, obtenez le crédit d'essai sur la page clé, et exécutez ceci :

curl https://api.cursoraiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the word ok."}]
  }'

Vous devriez recevoir un corps JSON avec un tableau choices. Les en-têtes de réponse incluent X-Balance-USD, qui indique le solde restant sur votre crédit. Le même appel en Python avec le SDK officiel :

from openai import OpenAI

client = OpenAI(
    base_url="https://api.cursoraiapikey.com/v1",
    api_key="YOUR_KEY",
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the word ok."}],
)
print(reply.choices[0].message.content)

Si les deux appels fonctionnent, la clé est correcte et toute erreur ultérieure provient des paramètres de l'éditeur.

Étape par étape dans l'éditeur

Inscrivez-vous avec Google ou avec un e-mail et un mot de passe, puis obtenez le crédit d'essai de $0,50 sur la page Clé API. Aucune carte n'est nécessaire et le crédit est valable 7 jours.
Copiez la clé. Traitez-la comme un mot de passe.
Dans l'éditeur, ouvrez Paramètres et allez dans la section Modèles. Les noms diffèrent selon les versions, traitez donc les libellés de cette liste comme un guide.
Collez la clé dans le champ Clé API OpenAI.
Activez l'option pour remplacer l'URL de base OpenAI et entrez https://api.cursoraiapikey.com/v1. Conservez le /v1 et n'ajoutez pas /chat/completions ; le client ajoute le reste.
Ajoutez un modèle personnalisé avec le nom exact uncensored.
Sélectionnez ce modèle dans le panneau de chat et envoyez un message court.

Si votre version propose une étape de vérification et qu'elle échoue alors que curl fonctionne, vérifiez que vous n'avez pas laissé d'espace à la fin de la clé et que l'URL de base ne contient pas de deuxième /v1 à la fin.

Ce qui utilisera ou non votre clé

Définir un endpoint personnalisé ne modifie pas nécessairement toutes les fonctionnalités. Les éditeurs exécutent souvent certaines fonctionnalités, comme la complétion en ligne ou l'application d'un diff, sur des modèles hébergés par le fournisseur lui-même, et ceux-ci peuvent ignorer votre clé. Les requêtes de chat et de style agent sont celles généralement envoyées à l'endpoint que vous configurez. La documentation de l'éditeur fait autorité pour votre version, consultez-la avant de planifier autour d'une fonctionnalité spécifique.

Deux autres points à vérifier :

Chemin de requête. Selon la version, les requêtes peuvent passer par des serveurs gérés par le fournisseur de l'éditeur avant d'atteindre votre endpoint. Si c'est le cas, une URL de base sur votre propre ordinateur portable ne fonctionnera pas, tandis qu'une URL publique comme celle-ci le fera. Lisez les notes de confidentialité de l'éditeur pour voir ce qu'il stocke.
Portée du modèle. Ce service exécute un seul modèle à poids ouverts, ajusté pour répondre sans refus de contenu pour une utilisation adulte légale. Il est texte uniquement. Il ne génère pas d'images, d'audio ou d'embeddings, donc les fonctionnalités nécessitant ceux-ci ne fonctionneront pas via lui.

La fenêtre de contexte est de 100 000 tokens pour le prompt plus la complétion, ce qui est largement suffisant pour la plupart des travaux sur un seul fichier et pour de nombreuses tâches multi-fichiers. Les dumps de dépôt très volumineux ne tiendront pas.

Correction des erreurs courantes

Symptôme	Cause probable	Correction
401 non autorisé	Clé incorrecte ou révoquée, espace supplémentaire, clé collée dans le mauvais champ	Régénérez la clé sur la page clé et collez-la à nouveau. L'ancienne clé cesse de fonctionner immédiatement.
404 non trouvé	URL de base manquant `/v1`, ou `/v1/v1` doublé	Utilisez exactement `https://api.cursoraiapikey.com/v1`.
Modèle non trouvé	Nom du modèle personnalisé tapé différemment	Le nom est `uncensored`, tout en minuscules.
429 avec `concurrency`	Trop de requêtes simultanées ; les clés d’essai autorisent 2	Attendez que les requêtes en cours se terminent, ou passez à une clé complète qui en autorise 8.
429 avec `rate_limited`	Dépassement de la limite par minute ; 60 en essai, 300 avec une clé complète	Ralentissez ; les boucles d’agents peuvent générer des pics.
429 avec `Retry-After: 5`	Surcharge temporaire	Réessayez après cinq secondes.

Les modes agent peuvent déclencher plusieurs requêtes à la fois, et une réponse en streaming conserve son slot jusqu’à la fin du flux. Avec une clé d’essai, cela rend la limite de concurrence facile à toucher. C’est normal, ce n’est pas un défaut de la clé.

Le coût d'une requête

La facturation est en paiement à l’usage à $0,15 par 1 M de tokens d’entrée et $0,50 par 1 M de tokens de sortie, prélevés sur le crédit prépayé. Les requêtes échouées ou refusées ne sont pas facturées. Un tour de chat typique dans un éditeur envoie le fichier ouvert et un historique, disons 20 000 tokens d’entrée, et reçoit 1 500 tokens de sortie :

Entrée : 20 000 x $0,15 / 1 000 000 = $0,0030
Sortie : 1 500 x $0,50 / 1 000 000 = $0,00075
Total : $0,00375, soit un peu moins de demi-cent

Le crédit d’essai de 0,50 $ couvre donc environ 133 tours de cette taille. Cela suffit pour un après-midi de tests réels. Lorsque vous décidez de continuer, les recharges vont de 20 $ à 500 $ en montants entiers, avec un bonus de 5 % à partir de 50 $, de 10 % à partir de 100 $ et de 15 % à partir de 200 $, payés en crypto (USDT sur TRC20 ou USDC sur Base). Le crédit n’expire jamais. La page tarification présente le tableau complet et la documentation liste tous les paramètres pris en charge.