Cursor avec une seule clé API pour tous les modèles
Collez votre clé RelaySwitch dans le champ OpenAI API Key de Cursor, remplacez la Base URL par https://api.relayswitch.io/v1, puis ajoutez les id des modèles à utiliser. Chaque modèle de chat de cette clé peut entrer dans le sélecteur de modèles, et les modes Agent et Ask fonctionnent tous les deux.
02Les étapes dans Cursor Settings
- Activez OpenAI API Key et collez la clé complète depuis la console.
- Activez Override OpenAI Base URL et saisissez https://api.relayswitch.io/v1, avec
/v1à la fin. - Cliquez sur Save. Les versions plus anciennes de Cursor nomment ce bouton Verify.
- Sous Models, ajoutez un à un les id à utiliser, exactement comme ils sont écrits dans la liste des modèles ; les id Claude fonctionnent aussi. Choisissez-en ensuite un dans le panneau de chat.
OpenAI API Key: sk-relay-...Override OpenAI Base URL: https://api.relayswitch.io/v1Models: gpt-6.1-sol03Le rôle de chaque champ
| OpenAI API Key | L'identifiant d'accès que Cursor envoie à chaque requête. Collez la clé complète depuis la console. |
| Override OpenAI Base URL | Envoie ces requêtes à https://api.relayswitch.io/v1, et non à OpenAI. |
| Models | La liste que propose le sélecteur de modèles. Ajoutez chaque id à utiliser exactement comme dans la liste des modèles, pas son nom d'affichage. |
04Choisir un modèle pour Cursor
Une requête Agent porte la conversation, les fichiers lus par Cursor et les résultats d'outils : les tokens d'entrée forment donc l'essentiel de la facture. Un modèle au prix d'entrée bas donne le coût par requête le plus faible. Le tableau suivant présente les modèles phares en USD par million de tokens ; la page de chaque modèle indique les prix d'entrée, d'entrée en cache et de sortie.
| Modèle | Éditeur | Entrée | Sortie | Contexte |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00 | $20.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716 | $9.70 | 1,000,000 |
| DeepSeek V4.1 Flash 1017deepseek-v4.1-flash-1017 | DeepSeek | $0.2425 | $1.164 | 1,048,576 |
| GLM 5.3 Flashglm-5.3-flash | Z.ai | $0.0873 | $0.1455 | 1,000,000 |
| GPT-6 Lunagpt-6-luna | OpenAI | $0.0625 | $0.20 | 1,050,000 |
| Qwen3.8 Maxqwen3.8-max | Qwen | $0.80 | $2.40 | 991,000 |
| Minimax M3.1 Flashminimax-m3.1-flash | MiniMax | $0.105 | $0.42 | 1,000,000 |
| Gemini 3.8 Flashgemini-3.8-flash | $0.4925 | $2.25 | 1,048,576 | |
| Grok 4.7grok-4.7 | xAI | $0.60 | $1.80 | 500,000 |
| Kimi K3kimi-k3 | Moonshot AI | $0.90 | $4.50 | 1,048,576 |
USD par million de tokens
05Mode Agent et modèles GPT
Quand l'override de la Base URL est actif, le mode Agent de Cursor envoie, pour les modèles GPT, un corps de requête au format Responses API vers le chemin Chat Completions. Cursor le consigne comme known issue sur son forum.
La passerelle lit ce corps comme la requête Chat Completions voulue et répond au format Chat Completions, avec ou sans streaming. Les id GPT fonctionnent en mode Agent comme en mode Ask, au même prix. Si vous préférez un agent dans le terminal, voyez la page Codex et la page Claude Code.
06Vérifier la connexion
Envoyez une requête comme celle qu'envoie Cursor, depuis la même machine. Envoyez ensuite un message dans Cursor avec l'un de vos id sélectionné ; la requête apparaît sur la page Usage de la console, avec ses tokens et son coût.
curl https://api.relayswitch.io/v1/chat/completions \ -H "Authorization: Bearer sk-relay-..." \ -H "content-type: application/json" \ -d '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "Reply with ok"}]}'07Facturation, cache et erreurs fréquentes
La création d'une clé et la pose d'un budget par clé sont expliquées sur la page Clé API Claude. Ce qu'il faut savoir sur la facture, puis les quatre erreurs les plus fréquentes :
- Les requêtes sont facturées au token au prix du modèle, sur votre solde prépayé.
- Quand la réponse signale des tokens d'entrée en cache, ils sont facturés au prix de l'entrée en cache du modèle, et non au prix d'entrée. Une longue conversation qui répète le même préfixe coûte moins cher par tour qu'une conversation neuve.
- Sur les offres Cursor Teams et Enterprise, Cursor compte les requêtes faites avec votre propre clé dans son usage et y ajoute ses propres frais par token. Ces frais sont facturés par Cursor, pas ici. D'après la documentation de Cursor sur les clés API, les offres individuelles ne sont pas comptées.
401 invalid_api_key | La clé est fausse ou révoquée. Recopiez-la depuis la console. |
404 model_not_found | L'id du sélecteur de modèles n'est pas dans la liste des modèles. Cherchez une faute de frappe, ou un nom d'affichage écrit à la place de l'id. |
402 insufficient_balance | Rechargez dans la console ; la clé refonctionne aussitôt. |
| Échec de Verify | La cause la plus courante est une Base URL sans /v1. Lancez le curl de la section précédente depuis la même machine. |
Questions fréquentes
- La Base URL dans Cursor doit-elle contenir /v1 ?
- Oui. Mettez https://api.relayswitch.io/v1 dans Override OpenAI Base URL, puis Cursor ajoute /chat/completions derrière. La cause la plus courante d'un échec de Verify est un /v1 oublié.
- Les modèles Claude fonctionnent-ils dans Cursor AI avec cette clé ?
- Oui. Chaque modèle de chat de la liste des modèles répond au format OpenAI qu'envoie Cursor : les id Claude, GPT, Gemini et DeepSeek s'ajoutent donc au même sélecteur de modèles avec une seule clé.
- Le mode Agent fonctionne-t-il avec sa propre clé API ?
- Oui, le mode Agent et le mode Ask fonctionnent tous les deux. Pour les modèles GPT, le mode Agent envoie un corps de requête au format Responses vers le chemin Chat Completions ; la passerelle le lit comme une requête Chat Completions et répond dans ce format, au même prix.
- Faut-il activer le streaming ?
- Non. Cursor utilise le streaming par défaut et n'a pas de bouton pour cela. Tous les modèles prennent en charge le streaming.
- Cursor facture-t-il des frais supplémentaires pour une clé personnelle ?
- D'après la documentation de Cursor sur les clés API, sur les offres Teams et Enterprise, les requêtes faites avec votre propre clé sont comptées dans l'usage de Cursor et soumises à des frais par token de Cursor, facturés par Cursor. Les offres individuelles ne sont pas comptées. Ici, les requêtes sont facturées au token au prix du modèle, sur le solde prépayé.
- Comment recharger le solde pour l'utiliser dans Cursor ?
- Rechargez dans la console par carte, y compris Apple Pay et Google Pay, ou avec USDT, USDC, BTC, ETH, SOL, dès $10. Le solde est tenu en dollars américains, n'expire pas, et il n'y a pas d'abonnement.
Tous les modèles dans le sélecteur de Cursor
Une clé, un solde prépayé, paiement par carte ou en crypto.
01Comment ça marche, et où sont les réglages
Cursor envoie ses requêtes au format OpenAI, et chaque modèle de chat de la liste des modèles répond à ce format. Une seule clé couvre donc Claude, GPT, Gemini et DeepSeek dans le même sélecteur de modèles, chacun à son prix au token du moment, facturé sur le solde prépayé.
Les réglages sont dans Cursor Settings (
Cmd/Ctrl + ,), section Models. Les champs de la clé et de la Base URL se trouvent sous la liste des modèles.