Skip to main content
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

Prérequis

Prérequis supplémentaires

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.
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é.

Configuration

1

Ouvrir les paramètres des modèles

Dans Cursor, cliquez sur Settings en bas à gauche, puis ouvrez Models. Faites défiler jusqu’à API Keys.
Page des paramètres Cursor affichant Settings, Models, API Keys, OpenAI API Key et Override OpenAI Base URL.
2

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://www.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.
3

Activer l’OpenAI API Key

Dans la boîte de dialogue de confirmation, cliquez sur Enable OpenAI API Key.
Boîte de dialogue Cursor demandant d’activer votre propre OpenAI API Key.
4

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.
Section Models de Cursor avec le bouton d’actualisation et les boutons d’activation des modèles.
5

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électeur de modèle du chat Cursor avec le bouton Auto à désactiver.
6

Sélectionner le modèle et commencer à discuter

Choisissez le modèle activé d’un fournisseur pris en charge, puis commencez à discuter.
Champ de chat Cursor avec un modèle activé sélectionné dans le sélecteur.

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.

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 SettingsModels.

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

Saisissez la Base URL https://www.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

Configuration avancée

Fournisseurs compatibles

Les états concernent la méthode de configuration de BetterToken décrite sur cette page.
  • Configuration manuelle : saisissez l’API Key, la Base URL et le Model.
  • Non compatible : aucune méthode de connexion directe vérifiée n’est disponible pour le moment.

Détails techniques

Cette configuration utilise https://www.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

  • N’utilisez pas de Model ID du fournisseur Claude dans le parcours Codex / compatible avec OpenAI
  • N’utilisez plus de noms de modèles Claude codés en dur ; choisissez un Model ID actuel d’un fournisseur pris en charge dans le model plaza