Cursor

Utilisez Override OpenAI Base URL de Cursor pour exécuter les modèles GPT du catalogue OneProvider dans Ask et Agent.

Éditeur de code IA Cursor

Ce qui fonctionne

Les requêtes Ask et Agent pour les ID de modèle GPT que vous ajoutez passent par OneProvider, y compris les requêtes ApplyPatch en streaming. Cursor envoie ces requêtes depuis ses propres serveurs, donc seul l’endpoint public fonctionne ; Cursor garde la main sur son environnement d’agent et sur ses fonctions hébergées spécialisées.

Limite du client

Nécessite une offre Cursor payante (Pro ou supérieure) : depuis janvier 2026, Cursor ignore vos propres clés sur l’offre Free. Le remplacement est global — tant qu’il est actif, tous les modèles sauf ceux d’Anthropic et de Google, y compris les propres modèles GPT, Composer et Grok de Cursor, sont envoyés à OneProvider ; désactivez-le pour réutiliser les modèles de Cursor. Les ID Anthropic/Claude et Google intégrés n’utilisent jamais le remplacement, et la complétion Tab ainsi que les fonctions hébergées par Cursor gardent leur routage habituel.

Configuration

1. Mettre à jour Cursor et préparer une clé dédiée

   Utilisez la dernière version stable de Cursor avec une offre Pro ou supérieure. Créez une clé OneProvider dédiée, limitez ses modèles et sa dépense, et rechargez le solde avant la vérification.

2. Activer l’OpenAI API Key

   Ouvrez Cursor Settings → Models → API Keys (Paramètres de Cursor → Modèles → Clés API), collez la clé OneProvider dédiée dans OpenAI API Key et activez son interrupteur — coller la clé ne suffit pas à l’activer.

   OpenAI API Key: sk-your-key-here

3. Remplacer la base URL d’OpenAI

   Activez Override OpenAI Base URL (Remplacer la base URL d’OpenAI) et saisissez exactement https://api.oneprovider.dev/v1 — avec /v1 et sans /chat/completions ; Cursor ajoute lui-même le chemin. Cursor exige un ID de modèle OpenAI compatible : choisissez dans le catalogue un ID de modèle de texte GPT (un modèle d’image ne fonctionnera pas dans le chat).

   Override OpenAI Base URL: https://api.oneprovider.dev/v1

4. Enregistrer et sélectionner un modèle compatible

   Enregistrez la clé OpenAI et la base URL. Ajoutez l’ID de modèle compatible choisi comme modèle personnalisé s’il n’est pas listé, puis lancez une nouvelle requête Ask ou Agent. Les ID de modèle Claude et Google ne passent pas par ce remplacement. Désactivez le remplacement quand vous voulez retrouver le routage OpenAI normal de Cursor.

Vérifier la connexion

Confirmer la requête dans votre Dashboard

La requête doit afficher gpt-6.1-terra, l’endpoint compatible OpenAI, la consommation de jetons et le montant débité. Si Cursor affiche une erreur à la place :

"does not work with your current plan or api key" → offre Free, ou interrupteur OpenAI API Key désactivé
"Model name is not valid" → activez l’interrupteur OpenAI API Key, démarrez un nouveau chat
404 / "Invalid URL" → la base URL doit être exactement https://api.oneprovider.dev/v1
401 → clé OneProvider incorrecte, révoquée ou sans solde
"model … is not available" → l’ID de modèle n’est pas dans le catalogue OneProvider
Les modèles propres à Cursor échouent → désactivez Override OpenAI Base URL pendant que vous les utilisez

Paramètres de connexion

Protocole

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Sécurité de la clé

Cursor assemble les requêtes via son propre service, ne restreignez donc pas la clé à l’IP de votre poste. Préférez une clé dédiée avec des contrôles de modèle, de débit, de dépense, d’expiration et de portée.

Quel modèle choisir

Le remplacement ne transporte que des ID de modèle au style OpenAI, choisissez donc un modèle de texte GPT. gpt-6.1-terra est le choix équilibré par défaut pour Ask et Agent. gpt-6.1-sol est le niveau frontière pour les tâches difficiles touchant plusieurs fichiers, et gpt-5.6-luna le niveau économique pour les questions rapides. Ajoutez l’ID choisi comme modèle personnalisé, exactement tel qu’il est écrit dans le catalogue . Les ID Claude ne passent jamais par ce remplacement : pour utiliser Claude, lancez Claude Code à côté de Cursor.

Erreurs courantes et solutions

« Model name is not valid »

L’interrupteur OpenAI API Key est désactivé, ou le modèle a été ajouté avant son activation. Activez l’interrupteur, enregistrez et démarrez un nouveau chat.

« Does not work with your current plan or api key »

Vous êtes sur l’offre Free, ou l’interrupteur est désactivé. Cursor ignore vos propres clés sur Free ; il faut Pro ou supérieur.

404 ou « Invalid URL »

Saisissez exactement https://api.oneprovider.dev/v1 : avec /v1, sans /chat/completions. Cursor ajoute le chemin.

401

La clé est incorrecte, révoquée, ou le solde est vide. Collez la clé entière sans espaces, et rechargez le solde de l’espace client.

Les modèles propres à Cursor échouent tant que le remplacement est actif

Le remplacement est global : tout modèle non Anthropic et non Google part vers OneProvider. Désactivez Override OpenAI Base URL pour réutiliser les modèles de Cursor.

Les requêtes n’apparaissent pas dans mon Dashboard

Le modèle utilisé est un modèle Claude ou Google, ou le remplacement est désactivé. Choisissez l’ID GPT que vous avez ajouté et lancez une nouvelle requête Ask ou Agent.

FAQ

La complétion Tab est-elle affectée ?

Non. Tab et les fonctions hébergées par Cursor gardent leur routage habituel.

Puis-je restreindre la clé à mon IP ?

Non. Cursor envoie les requêtes depuis ses propres serveurs, donc une liste d’IP autorisées les bloquerait. Utilisez plutôt des limites de modèle, de débit et de dépense.

Puis-je utiliser des modèles Claude dans Cursor via OneProvider ?

Pas via ce remplacement. Pour Claude, utilisez Claude Code ou Cline .

Comment revenir en arrière ?

Désactivez Override OpenAI Base URL. Vos autres paramètres sont conservés.

Réponses rapides

Quelle base URL utiliser ?

Claude Code et les SDK Anthropic utilisent https://api.oneprovider.dev. Les SDK OpenAI et les clients compatibles OpenAI utilisent https://api.oneprovider.dev/v1. Une seule clé fonctionne avec les deux ; la liste des modèles est sur la page des modèles , les tarifs sur la page des tarifs .

Comment s’authentifier ?

Envoyez la clé sk-… telle quelle dans x-api-key ou Authorization: Bearer : l’un des deux, jamais les deux. Conservez la clé dans une variable d’environnement, pas dans un fichier qui sera commité. En savoir plus sur l’authentification .

Où obtenir une clé ?

Ouvrez votre espace client dans le bot Telegram @oneprovider_robot ou sur app.oneprovider.dev, rechargez le solde et appuyez sur « Créer une clé ». Chaque clé peut avoir sa propre limite de dépense. Espace client et clés API .

Que signifient 401, 404 et 429 ?

401 : la clé est absente, mal saisie ou envoyée dans le mauvais en-tête ; collez la clé entière, sans guillemets ni espaces. 404 : le plus souvent une base URL incorrecte, par exemple un /v1 manquant ou en double. 429 avec « Insufficient balance » : le solde de l’espace client est à zéro ou la clé a atteint sa limite de dépense, donc rechargez au lieu de réessayer ; tout autre 429 est une limite de débit, donc attendez le délai indiqué par Retry-After. Détails : codes d’erreur et dépannage .

Pourquoi les flux se coupent-ils ou se réinitialisent-ils ?

Les VPN et les proxys VLESS mettent souvent le SSE en mémoire tampon ou perturbent la négociation HTTP/2. OneProvider n’a aucune restriction régionale et ne met pas les flux en mémoire tampon : désactivez le proxy et réessayez.

Où demander de l’aide si cela ne suffit pas ?

Écrivez à @Oneproviderhelpbot sur Telegram ou ouvrez « Support » dans l’espace client web, en indiquant le code de statut HTTP et le message d’erreur exact. Comment fonctionne le support .