FR ▾
Obtenir une clé API

cursorapikey.com/Guide

Comment utiliser les clés API Cursor avec un endpoint personnalisé

Voici comment utiliser les paramètres API Cursor avec votre propre endpoint : collez une clé, remplacez l'URL de base OpenAI et ajoutez le nom de modèle uncensored. Les étapes ci-dessous prennent environ cinq minutes et incluent un test curl que vous pouvez exécuter en premier.

Mis à jour le

Éditeur de code isométrique connecté par un câble lumineux à un cube de serveur, illustrant un endpoint API personnalisé

Points clés

  • Cursor vous permet de remplacer l'URL de base OpenAI et la clé, afin que n'importe quel endpoint compatible OpenAI puisse servir les requêtes.
  • Utilisez l'URL de base https://api.cursorapikey.com/v1 et l'ID de modèle uncensored.
  • Testez la clé avec curl avant de toucher à l'éditeur, afin de savoir de quel côté vient une erreur.
  • Un prompt de 20 000 tokens avec une réponse de 1 000 tokens coûte 0,0035 $.

Ce que couvre ce guide

Les personnes qui recherchent comment utiliser l'API Cursor veulent généralement dire l'une de ces deux choses. Soit elles veulent appeler un service Cursor depuis du code, soit elles veulent que l'éditeur Cursor envoie ses requêtes de modèle à un endpoint de leur choix. Ce guide concerne le deuxième cas. Ce site est une API hébergée indépendante qui parle le protocole de complétions de chat OpenAI, de sorte que Cursor peut communiquer avec elle de la même manière qu'il communique avec n'importe quel serveur de style OpenAI.

Le modèle qui le sous-tend est un modèle à poids ouverts unique, exécuté par un fournisseur indépendant et ajusté pour répondre sans refus de contenu pour une utilisation adulte légale. Il ne s'agit pas d'un modèle officiel Cursor, ni d'un routeur entre fournisseurs. Il ne gère que le texte. Pour le code, cela suffit généralement : vous envoyez du code et des instructions, vous recevez du code et des explications en retour.

Vous avez besoin de trois choses : une clé API, l'URL de base https://api.cursorapikey.com/v1, et l'ID de modèle uncensored. Le reste est une question de trouver les bons champs dans l'éditeur.

Étape 1 : obtenir une clé et la vérifier avec curl

Créez un compte avec Google ou avec adresse e-mail et mot de passe, puis ouvrez la page clé API. Les nouveaux comptes peuvent y réclamer 0,50 $ de crédit d'essai en un clic. Aucune carte n'est nécessaire et le crédit reste valable 7 jours. La clé d'essai est limitée à 2 requêtes simultanées et 60 requêtes par minute, ce qui suffit pour une première session dans l'éditeur.

Avant d'ouvrir Cursor, confirmez que la clé fonctionne. Exécutez ceci dans un terminal, avec votre clé dans une variable d'environnement :

export API_KEY="paste-your-key-here"

curl https://api.cursorapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

curl https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Write a Python function that reverses a linked list."}
    ]
  }'

Le premier appel liste le modèle. Le second retourne une complétion de chat normale. Si les deux réussissent, toute erreur ultérieure dans l'éditeur est un problème de configuration et non un problème de clé. Cette séparation évite beaucoup de devinettes.

Étape 2 : définir l'URL de base et la clé dans Cursor

Ouvrez les paramètres de Cursor et allez à la section des modèles. Les noms de menu et la mise en page changent entre les versions, donc considérez les étiquettes ci-dessous comme une carte et consultez la documentation de Cursor si quelque chose a bougé.

  1. Trouvez le champ pour une clé API OpenAI et collez votre clé de ce site.
  2. Activez l'option pour remplacer l'URL de base OpenAI et saisissez https://api.cursorapikey.com/v1. Conservez le /v1 à la fin et n'ajoutez pas /chat/completions ; le client ajoute le chemin lui-même.
  3. Ajoutez un modèle personnalisé et tapez uncensored exactement, en minuscules.
  4. Utilisez le bouton de vérification ou de sauvegarde si l'éditeur en propose un, puis sélectionnez le nouveau modèle dans le panneau de chat.

Envoyez un court message tel que "explique cette fonction" avec un fichier ouvert. Une réponse en streaming signifie que la route fonctionne de bout en bout. Cursor envoie la requête, l'endpoint diffuse des tokens en retour via SSE, et l'éditeur les affiche à mesure qu'ils arrivent.

Deux mises en garde. Certaines fonctionnalités de l'éditeur, telles que la complétion inline par Tab, peuvent s'exécuter sur des modèles contrôlés par Cursor et peuvent ignorer votre clé, alors vérifiez quelles fonctionnalités utilisent réellement le modèle personnalisé. Et comme Cursor peut acheminer le trafic à clé personnalisée via ses propres serveurs, lisez sa documentation actuelle si vous devez savoir exactement où votre code circule. Le guide de démarrage rapide sur ce site liste le côté API du contrat.

Testez le même endpoint depuis du code

Le moyen le plus simple d'isoler un problème est d'appeler l'endpoint avec le SDK OpenAI officiel. Si cela fonctionne, l'endpoint est bon et tout problème restant est dans la configuration de l'éditeur.

from openai import OpenAI

client = OpenAI(
    api_key="paste-your-key-here",
    base_url="https://api.cursorapikey.com/v1",
)

stream = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a terse senior engineer."},
        {"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n    if x > 0:\n        out.append(x * 2)"},
    ],
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

La même chose en Node :

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.cursorapikey.com/v1",
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});

console.log(res.choices[0].message.content);

Les réponses en streaming incluent l'utilisation à la fin, afin que vous puissiez enregistrer exactement combien de tokens une requête a utilisés. Chaque réponse inclut également un en-tête X-Balance-USD avec votre crédit restant et un X-Request-Id que vous pouvez citer si quelque chose semble incorrect.

Ce qui fonctionne dans un flux de travail de codage

L'API prend en charge le streaming, le mode JSON et l'appel de fonctions (tools, tool_choice, tool_calls streamés, et les résultats renvoyés en tant que role: "tool"). Les paramètres d'échantillonnage tels que temperature, top_p, stop, seed et les pénalités sont transmis. La fenêtre de contexte est de 100 000 tokens, partagée entre le prompt et la complétion, et max_tokens est optionnel.

Ces 100 000 tokens constituent un budget généreux pour le code. Un fichier source de quelques centaines de lignes représente quelques milliers de tokens, vous pouvez donc inclure plusieurs fichiers plus une longue instruction et laisser encore de la place pour la réponse. Le corps de requête maximum est de 8 Mo, ce que vous n'atteindrez pas avec du texte.

Certaines habitudes qui rendent un modèle personnalisé agréable dans un éditeur :

  • Conservez une temperature faible pour les modifications de code. Des valeurs autour de 0,2 donnent une sortie plus stable ; augmentez-la uniquement pour le brainstorming.
  • Joignez uniquement les fichiers qui comptent. Chaque token que vous envoyez est facturé en entrée, et toute la conversation est renvoyée à chaque tour.
  • Demandez des diffs ou la fonction modifiée, et non le fichier entier, lorsque le fichier est long. Les tokens de sortie coûtent plus cher que les tokens d'entrée.
  • Utilisez le modèle pour des tâches où les refus font obstacle, comme écrire des preuves de concept d'exploitation pour votre propre laboratoire, analyser des échantillons de logiciels malveillants que vous êtes autorisé à étudier, ou générer des données de test qui imitent du contenu réel choquant ou désordonné. Tout cela doit être légal.

La limite stricte à répéter : aucun contenu sexuel impliquant des mineurs, sous quelque forme que ce soit.

Correction des erreurs courantes

SymptômeCause probableCorrection
401 ou « clé invalide »Clé collée avec un espace, ou ancienne cléRecopiez depuis la page de clé ; testez avec curl
404 ou "modèle non trouvé"Nom de modèle tapé différemmentUtilisez uncensored, en minuscules, sans suffixe
404 sur le cheminL'URL de base inclut /chat/completionsTerminez l'URL de base à /v1
429 avec concurrencyTrop de requêtes à la foisAttendez que les flux se terminent ; une clé complète permet 8, une clé d'essai 2
429 avec rate_limitedPlus de 300 requêtes par minute (60 en essai)Ralentissez, ou réessayez après une pause
429 avec Retry-After: 5Surcharge temporaireRéessayez après cinq secondes

Une requête en streaming occupe son slot de concurrence jusqu'à la fin du stream. Si vous lancez plusieurs chats dans Cursor et les laissez générer, vous pouvez atteindre la limite de concurrence sur une clé d'essai rapidement. Les requêtes échouées ou refusées ne sont pas facturées, donc réessayer ne coûte rien de plus.

Combien coûte une session de code

La tarification est de 0,15 $ par 1M de tokens d'entrée et de 0,50 $ par 1M de tokens de sortie, prélevés sur le crédit prépayé sans abonnement. Une requête d'éditeur typique comporte un long prompt (vos fichiers) et une réponse courte. Prenons 20 000 tokens d'entrée et 1 000 tokens de sortie :

  • Entrée : 20 000 x 0,15 $ / 1 000 000 = 0,0030 $
  • Sortie : 1 000 x 0,50 $ / 1 000 000 = 0,0005 $
  • Total : 0,0035 $ par requête

À 100 requêtes en une journée de travail, cela représente 0,35 $. Le crédit d'essai de 0,50 $ couvre environ 140 de ces requêtes. Après l'essai, vous pouvez recharger n'importe quel montant entier de 20 $ à 500 $, avec un crédit bonus de +5 % à partir de 50 $, +10 % à partir de 100 $ et +15 % à partir de 200 $. Payez par crypto (USDT sur TRC20, USDC sur Base). Le crédit n'expire jamais, donc une recharge que vous utilisez lentement n'est pas gaspillée. La page de tarification contient le tableau complet, et la page sur l'alternative à Cursor et Copilot explique où cela s'intègre à côté des éditeurs par abonnement.

Les prompts ne sont pas utilisés pour l'entraînement.

01

Questions et réponses

Cela fonctionne-t-il avec l'agent Cursor et l'appel d'outils ?

L'API prend en charge l'appel de fonctions avec les outils, tool_choice et les tool_calls en streaming. Le fait qu'une fonctionnalité Cursor donnée utilise votre modèle personnalisé dépend de l'éditeur ; testez donc chaque fonctionnalité après la configuration.

Quel nom de modèle dois-je saisir ?

Saisissez uncensored, en minuscules. C'est le seul ID de modèle, et GET /v1/models le répertorie.

S'agit-il de l'API officielle de Cursor ?

Non. Il s'agit d'une API indépendante compatible OpenAI devant un seul modèle à poids ouverts. Cursor se contente de vous permettre de pointer ses paramètres OpenAI vers un endpoint différent.

Ai-je besoin d'une carte pour l'essayer ?

Non. Le crédit d'essai de 0,50 $ est obtenu en un clic sur la page clé API après la création de compte, sans besoin de carte, et est valable 7 jours.

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.