URL de base manquante
La cause la plus fréquente. Si OpenAI Base URL est vide, Cursor envoie votre clé RunAPI à api.openai.com, qui la rejette. Définissez l'URL de base sur https://runapi.ai/v1 et l'erreur disparaît.
GUIDE DE CONFIGURATION
Comment utiliser votre propre clé API dans Cursor IDE
Cursor Pro costs $20/month with a usage cap. With a RunAPI key you pay per token — the same Claude and GPT-4o models at 50% off official rates, no monthly fee, no Pro subscription required. This guide covers where to paste your key in Settings > Models, how to set the base URL (the step most guides skip), and how to fix the common 'unauthorized user api key' error.
Mis à jour le June 23, 2026
RunAPI Editorial
En un coup d'œil
Puis-je utiliser Cursor avec ma propre clé API ?
Yes. Cursor lets you add your own API key on the free plan — you do not need Cursor Pro. Go to Settings > Models, scroll to the OpenAI section, and fill in two fields: the OpenAI Base URL (https://runapi.ai/v1) and the OpenAI API Key (your RunAPI key). RunAPI gives you access to Claude 3.5 Sonnet, GPT-4o, Gemini, and other models at 50% of what Anthropic and OpenAI charge directly. The most common setup error — the 'unauthorized user api key' message — means the base URL field is empty, so Cursor is sending your key to the wrong endpoint.
Fonctionne sur tous les plans Cursor
You do not need a Pro subscription to use your own API key. BYOK works on the free Cursor tier and on Pro.
Point de terminaison compatible OpenAI
RunAPI uses the same request and response format as the OpenAI API. Cursor's OpenAI API Key field accepts it without any code changes.
50 % de réduction sur les prix officiels des modèles
RunAPI facture à moitié du prix catalogue du fournisseur. L'entrée Claude 3.5 Sonnet coûte 1,50 $/M tokens via RunAPI contre 3,00 $/M directement via Anthropic.
Corriger 'unauthorized user api key'
This error almost always means the OpenAI Base URL field is empty. Set it to https://runapi.ai/v1 alongside your key and the error clears.
Présentation des paramètres
Où saisir votre clé API dans Cursor
Cursor keeps all model configuration in one place. Open Cursor, press Cmd+Shift+J (Mac) or Ctrl+Shift+J (Windows/Linux) to open Settings, then click the Models tab on the left. Find the OpenAI section — you need to fill in two fields there. The OpenAI Base URL tells Cursor to send requests to RunAPI instead of OpenAI directly. The OpenAI API Key field is where you paste your RunAPI key. Both fields must be set. If you leave the base URL blank, Cursor sends your key to api.openai.com, which will reject it every time.
Dépannage
Corriger l'erreur 'unauthorized user api key' dans Cursor
The 'unauthorized user api key' message from Cursor means one of three things. First, the OpenAI Base URL field is empty, so Cursor sends your RunAPI key to api.openai.com, which rejects it — this is the most common cause. Second, the key was copied with a leading or trailing space. Third, the key was revoked or regenerated and the old value is stale. RunAPI keys start with 'rp-' and are not standard OpenAI keys — they will always fail if Cursor tries to authenticate them against openai.com. Always set the base URL alongside the key. If a specific model still returns an error after the key and URL are correct, double-check the model name matches the exact slug shown at runapi.ai/pricing — a mismatch returns a different error than an auth failure.
Clé copiée avec des espaces supplémentaires
Paste the key and look for a leading or trailing space. Some terminals and browsers add invisible whitespace when you copy. Delete the field and paste again if in doubt.
Clé expirée ou révoquée
Les clés RunAPI peuvent être révoquées depuis le tableau de bord. Si vous avez récemment régénéré votre clé, l'ancienne valeur renverra une erreur 401. Copiez la nouvelle clé depuis Dashboard > API Keys.
Mauvais slug de modèle
Si la clé et l'URL sont correctes mais qu'un modèle spécifique renvoie une erreur, le nom du modèle ne correspond peut-être pas au catalogue RunAPI. Vérifiez le slug exact sur runapi.ai/pricing et collez-le dans le champ de modèle de Cursor.
Cursor Pro vs BYOK avec RunAPI
Cursor Pro à 20 $/mois vaut-il la peine, ou devriez-vous utiliser votre propre clé ?
Cursor Pro gives you a fixed monthly allowance of fast-model requests. Once you hit the cap, Cursor slows you down or stops until the month resets. BYOK with RunAPI has no cap — you pay per token at 50% of official rates. For most developers, the break-even point is around 8–12 hours of heavy AI coding per month. Below that, RunAPI costs less. Above that, a subscription becomes more predictable but not necessarily cheaper.
Premiers pas
Comment configurer Cursor avec votre propre clé API
1
Créer un compte RunAPI gratuit
Rendez-vous sur runapi.ai et inscrivez-vous. Aucune carte de crédit n'est requise. Vous obtenez un petit crédit gratuit pour tester la connexion.
2
Copier votre clé API et l'URL de base
In the RunAPI dashboard, go to API Keys and generate a key. Copy it right away and note the base URL — it is https://runapi.ai/v1.
3
Ouvrir les paramètres Cursor
In Cursor, press Cmd+Shift+J (Mac) or Ctrl+Shift+J (Windows/Linux) to open Settings. Click the Models tab on the left sidebar.
4
Saisir l'URL de base
Scroll to the OpenAI section. Paste https://runapi.ai/v1 into the OpenAI Base URL field. Most guides skip this step — without it, Cursor sends all requests to OpenAI and rejects your key.
5
Paste your key and click Enable
Paste your RunAPI key into the OpenAI API Key field. Check that there is no leading or trailing whitespace. Toggle the OpenAI section on if it is off, then click Verify or Enable.
6
Sélectionner un modèle et tester
In the Cursor chat bar, choose a model such as gpt-5.4. Send a test message. A response confirms the connection works. Check your RunAPI dashboard under Usage to see the request logged.
Questions fréquentes
FAQ sur la configuration de la clé API Cursor
Pourquoi Cursor affiche-t-il 'unauthorized user api key' ?
Cette erreur apparaît lorsque Cursor ne peut pas authentifier votre clé contre le point de terminaison ciblé. La raison la plus fréquente est que le champ OpenAI Base URL est vide, ce qui amène Cursor à envoyer votre clé RunAPI à api.openai.com, qui la rejette. Définissez l'URL de base sur https://runapi.ai/v1 avec votre clé pour y remédier.
Do I need a Pro version of Cursor to add custom API keys?
No — you do not need a Pro subscription to use your own API key. Cursor lets you add custom API keys on the free plan. Go to Settings > Models, paste your key into the OpenAI API Key field, set the base URL, and you are done. Cursor's own built-in model requests have separate limits, but those do not apply when you supply your own key.
Quels modèles puis-je utiliser dans Cursor via RunAPI ?
Tout modèle du catalogue RunAPI qui expose un point de terminaison de complétions de chat — notamment Claude 3.5 Sonnet, Claude 3.7 Sonnet, GPT-4o, GPT-4.1, Gemini 1.5 Pro et Llama 3.1. Saisissez le slug de modèle exact de runapi.ai/pricing dans le champ de modèle de Cursor. Les modèles d'image et d'audio ne sont pas disponibles dans l'interface de chat de Cursor.
RunAPI est-il moins cher que Cursor Pro ?
Pour une utilisation légère à modérée, oui. Cursor Pro à 20 $/mois convient aux développeurs qui préfèrent un forfait fixe. RunAPI facture par token à 50 % des prix catalogue des fournisseurs — Claude 3.5 Sonnet coûte 1,50 $/M tokens d'entrée. Les utilisateurs intensifs qui restent dans le plafond Pro trouveront peut-être l'abonnement plus prévisible, mais il n'y a pas de limitation avec RunAPI.
Puis-je utiliser la même clé RunAPI dans Windsurf et Claude Code ?
Oui. Une clé RunAPI fonctionne dans Cursor, Windsurf, Claude Code, Codex et tout autre outil acceptant un point de terminaison compatible OpenAI personnalisé. L'utilisation et les dépenses sont consolidées dans un tableau de bord RunAPI unique, de sorte que vous n'avez pas besoin de gérer des clés ou des soldes séparés par outil.
Quelle est l'URL de base OpenAI à saisir dans Cursor ?
Définissez-la sur https://runapi.ai/v1. Cursor utilise cette URL pour toutes les requêtes de modèle lorsque la section OpenAI est active. Sans ce champ, Cursor envoie vos requêtes à api.openai.com, qui rejettera une clé RunAPI et renverra une erreur non autorisée à chaque fois.
L'utilisation de BYOK dans Cursor désactive-t-elle les fonctionnalités intégrées de Cursor ?
Non. La complétion automatique, la vue diff et les fonctionnalités d'agent de Cursor continuent de fonctionner. BYOK modifie uniquement le modèle et le point de terminaison utilisés par Cursor pour le chat et les complétions en ligne. Si vous définissez un modèle que l'interface de Cursor ne liste pas par défaut, saisissez le slug directement dans le sélecteur de modèle.
Comment savoir si ma clé RunAPI fonctionne dans Cursor ?
Envoyez un court message dans le chat Cursor et vérifiez le tableau de bord RunAPI sous Utilisation. Une nouvelle entrée de journal avec le nom du modèle, le nombre de tokens et le coût apparaît quelques secondes après chaque requête. Si aucune entrée n'apparaît, l'URL de base ou la clé n'atteint pas RunAPI.
ARTICLES CONNEXES
Explorer davantage
Configuration API VS Code
Utilisez les modèles RunAPI dans VS Code Copilot Chat et les extensions.
Configuration API Claude Code
Guide etape par etape pour connecter Claude Code à RunAPI.
Claude Code vs Cursor
Comparatif fonctionnel et tarifaire des deux principaux outils de codage IA.
RunAPI CLI
Lancez n'importe quel modele depuis votre terminal en une seule commande.
Commencez à utiliser Cursor avec votre propre clé API dès aujourd'hui
RunAPI gives you an OpenAI-compatible API key for Claude, GPT-4o, Gemini, and more at 50% off official rates. Paste it into Cursor's OpenAI API Key field in under two minutes and pay only for what you use.