Configurer Cursor : clé API, Base URL et modèles

Pour connecter Cursor à BetterToken, préparez une API Key, saisissez la Base URL ci-dessous et choisissez un Model ID actuel dans le model plaza.

Paramètres principaux

Champ	Valeur
API Key	Utiliser la BetterToken API Key
Base URL	https://bettertoken.ai/v1
Modèle	Un Model ID actuel provenant du model plaza

Prérequis

• La version actuelle de l’outil est installée
• Une BetterToken API Key : créez un compte et obtenez-en une
• Un Model ID provenant du model plaza

Inscrivez-vous et obtenez une BetterToken API Key→

Vous avez déjà un compte ? Connectez-vous, rechargez votre solde, puis créez une clé dans la console.

Prérequis supplémentaires

• Cursor est installé (télécharger Cursor)

Installation

Téléchargez et installez la version actuelle depuis le site de Cursor. Connectez-vous avec un compte Cursor compatible avec les modèles personnalisés, puis poursuivez ci-dessous.

Cursor permet uniquement aux utilisateurs d’une offre avancée payante ou supérieure de configurer des modèles personnalisés. Si votre compte ou votre version du client n’affiche pas les options de modèle personnalisé, d’API Key ou de Base URL, vérifiez d’abord votre offre Cursor et la version du client.

Les règles BYOK de Cursor limitent OpenAI BYOK aux modèles de chat standard, sans raisonnement. La complétion Tab continue d’utiliser les modèles intégrés de Cursor. Les requêtes passent par le backend de Cursor pour construire les prompts ; l’API Key accompagne chaque requête et n’est pas conservée après son exécution. Le traitement des données BYOK suit la politique du fournisseur choisi, plutôt que la politique Zero Data Retention de Cursor.

Sur les offres Teams et Enterprise, les requêtes BYOK éligibles comptent aussi dans l’utilisation de Cursor selon le Cursor Token Rate, tandis que le fournisseur du modèle facture séparément le coût du modèle. Vérifiez les crédits de votre équipe, l’utilisation à la demande et les plafonds de dépenses : les requêtes peuvent s’arrêter lorsque le quota est épuisé. Les offres individuelles ont des règles différentes ; consultez les détails des offres.

Problème connu : Override OpenAI Base URL est un paramètre global. Lorsqu’il est activé, il affecte toutes les API Key configurées dans Cursor, y compris les Key Anthropic et GPT utilisées par les modèles intégrés. La communauté officielle de Cursor a confirmé ce comportement : la définition d’une Base URL affecte toutes les API Key et tous les modèles (discussion de la communauté).

Si les modèles Claude / GPT intégrés à Cursor cessent de fonctionner après l’activation de Override OpenAI Base URL, désactivez Override OpenAI Base URL lorsque vous n’utilisez pas BetterToken. Cursor ne permet pas encore de définir une Base URL différente pour chaque modèle ; cette fonction fait toujours l’objet d’une demande (demande de fonctionnalité).

Configuration manuelle

Effectuez cette configuration dans l’interface de Cursor. Aucun fichier de configuration ne doit être modifié.

Champ Cursor	Valeur
Override OpenAI Base URL	Activer
Base URL	https://bettertoken.ai/v1
OpenAI API Key	Utiliser la BetterToken API Key
Modèle personnalisé	Un Model ID complet provenant d’un fournisseur pris en charge

Configuration

Ouvrir les paramètres des modèles

Dans Cursor, cliquez sur Settings en bas à gauche, puis ouvrez Models. Faites défiler jusqu’à API Keys.

Saisir la Base URL et l’API Key

Dans API Keys, configurez les champs dans cet ordre :

1. Activez Override OpenAI Base URL
2. Saisissez https://bettertoken.ai/v1 dans le champ Base URL
3. Collez votre BetterToken API Key dans OpenAI API Key
4. Une fois l’URL et la Key renseignées, activez le bouton OpenAI API Key

Saisissez la Key avant d’activer le bouton. Cursor affichera alors la boîte de dialogue de confirmation de l’authentification.

Activer l’OpenAI API Key

Dans la boîte de dialogue de confirmation, cliquez sur Enable OpenAI API Key.

Actualiser la liste et activer les modèles

De retour dans Models, cliquez sur le bouton d’actualisation à droite avant de sélectionner un modèle. Attendez la fin de l’actualisation de la liste.

Sélectionnez uniquement les modèles du fournisseur pris en charge par l’endpoint configuré. Avec une BetterToken API Key, choisissez un Model ID du fournisseur pris en charge dans le model plaza, puis activez le bouton de ce modèle.

Revenir au chat et désactiver Auto

Après la configuration, revenez à l’écran de chat de Cursor et ouvrez le sélecteur de modèle sous le champ de saisie. Si Auto est activé, désactivez d’abord Auto.

Sélectionner le modèle et commencer à discuter

Choisissez le modèle activé d’un fournisseur pris en charge, puis commencez à discuter.

Vérifier la connexion

Envoyez un court prompt de test. Si l’outil répond sans erreur d’authentification ni de Model ID, la connexion fonctionne. Redémarrez complètement l’outil après avoir modifié sa configuration.

Limites du CLI Cursor

Le CLI Cursor officiel (cursor-agent) utilise l’authentification du compte Cursor : CURSOR_API_KEY est une clé Cursor, pas une BetterToken API Key. Son option --endpoint indique l’adresse du service Cursor ; les références officielles sur l’authentification et les paramètres ne documentent pas de Base URL compatible OpenAI. La configuration BYOK de l’application de bureau présentée sur cette page ne s’applique pas au CLI Cursor.

Changer de modèle

Ouvrez le sélecteur de modèle ou modifiez le champ Model dans la configuration. Utilisez le Model ID exact provenant du model plaza, puis redémarrez la session en cours.

Erreurs fréquentes

Erreurs liées à l’API personnalisée et à l’API Key

Avant de changer de modèle ou de Key, comparez vos paramètres avec la configuration d’une API OpenAI personnalisée dans Cursor.

Cursor n’affiche pas les champs Custom API, API Key ou Base URL

Vérifiez votre offre Cursor et la version du client. Les modèles personnalisés sont disponibles uniquement avec certaines offres payantes. Après la mise à jour de Cursor, ouvrez de nouveau Settings → Models.

L’API Key ne peut pas être activée ou vérifiée

Saisissez la Base URL https://bettertoken.ai/v1 et l’API Key avant d’activer le bouton OpenAI API Key. N’ajoutez pas /chat/completions à la Base URL et n’utilisez pas de Key du fournisseur Claude.

Le modèle est absent après l’actualisation

Vérifiez que le Model ID sélectionné provient du fournisseur pris en charge, attendez la fin de l’actualisation et activez uniquement un modèle de ce fournisseur. Le model plaza répertorie les ID actuels.

Les modèles intégrés de Cursor ne fonctionnent plus

Override OpenAI Base URL est un paramètre global. Lorsque vous n’utilisez pas BetterToken, désactivez-le pour que Cursor utilise de nouveau sa propre Base URL.

Le chat sélectionne un autre modèle

Ouvrez le sélecteur de modèle et désactivez Auto. Sélectionnez ensuite manuellement le modèle que vous avez activé.

Questions associées

• Configurer une API OpenAI personnalisée dans Cursor

• Comprendre Cursor Rules, AGENTS.md et .cursorignore

• Configurer MCP dans Cursor

• Claude Code ou Cursor pour le développement local

• Configurer un fournisseur personnalisé dans Codex CLI

• Configurer une API compatible avec OpenAI dans Cline

• API compatible avec OpenAI ou API compatible avec Anthropic

• Comparer tous les outils pris en charge

• Erreurs API, codes de statut et limites de débit

Détails techniques

Protocole, endpoint et champs internes du fournisseur

Cette configuration utilise https://bettertoken.ai/v1. L’outil ajoute le chemin de l’endpoint compatible avec OpenAI. N’ajoutez ni /chat/completions ni /responses, sauf si un champ l’exige explicitement.

Remarques

• Copiez le Model ID exact depuis la model plaza.