Utiliser Cursor avec une API LLM gratuite
Cursor peut envoyer des requêtes de chat vers votre propre clé API OpenAI. Ce guide montre comment relier cette clé à des modèles gratuits via FreeLLMAPI. Il indique aussi les limites. Cursor fait passer chaque requête par ses propres serveurs, et la complétion Tab utilise toujours les modèles de Cursor.
Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.
Ce qui fonctionne et ce qui ne fonctionne pas
Lisez cette section avant de commencer. La prise en charge des clés personnelles par Cursor est plus limitée que dans la plupart des autres éditeurs.
| Fonction de Cursor | Avec votre propre clé | Source |
|---|---|---|
| Chat avec un modèle de type OpenAI standard | Oui. Cursor documente les clés OpenAI personnelles pour les modèles de chat standard, sans raisonnement. | Page d'aide sur les clés API de Cursor |
| Complétion Tab | Non. Cursor indique que Tab continue d'utiliser les modèles intégrés de Cursor. | Page d'aide sur les clés API de Cursor |
| Mode Agent et Composer | Non confirmé. La documentation de Cursor ne cite que les modèles de chat. Testez-le avec votre offre avant de vous y fier. | Non documenté |
| Requêtes depuis localhost | Non. Cursor envoie toutes les requêtes par ses serveurs pour construire le prompt, donc localhost sur votre ordinateur n'entre pas dans le chemin. | Page d'aide sur les clés API de Cursor |
Les offres comptent aussi. La page tarifaire de Cursor liste les modèles tiers et les clés API personnelles pour les offres Premium, Super et Ultra. Elle indique que l'offre Plus n'a pas de clés API personnelles. Pour l'offre Free, la page indique que les modèles tiers ne sont pas disponibles. Vérifiez la page tarifaire de votre offre avant de continuer.
localhost. Lisez Cline, Roo Code and Kilo Code with a free API.Étape 1 : installer FreeLLMAPI et le rendre accessible
FreeLLMAPI est open source et tourne sur votre ordinateur dans Docker. Installez-le, puis ajoutez au moins deux clés de fournisseurs gratuits sur la page Keys.
Installer sur macOS ou Linux
curl -fsSL https://freellmapi.co/install.sh | bashCopiez votre clé unifiée depuis la page Keys. Donnez ensuite à la passerelle une adresse HTTPS publique, car les serveurs de Cursor ne peuvent pas atteindre votre localhost. Utilisez un tunnel HTTPS de confiance ou un serveur que vous contrôlez. Le guide FreeLLMAPI pour Cursor affiche ces étapes :
Afficher le guide Cursor
npx freellmapi setup-cursorCette commande n'écrit aucun fichier. Cursor n'a pas de fichier de configuration pour ce réglage, vous saisissez donc les valeurs dans les paramètres de Cursor.
Authorization, créez un jeton d'URL révocable séparément sur Keys, Agents. Révoquez-le quand vous arrêtez.Étape 2 : définir la clé et l'URL de base dans Cursor
- Ouvrez Cursor Settings.
- Ouvrez Models.
- Repérez le champ de clé API OpenAI. Collez votre clé unifiée FreeLLMAPI. Cliquez sur Save.
- Activez le remplacement de l'URL de base OpenAI. Le guide FreeLLMAPI nomme ce réglage Override OpenAI Base URL.
- Saisissez votre adresse publique avec
/v1à la fin, par exemplehttps://<your-tunnel-host>/v1. - Sélectionnez un modèle dans le sélecteur de modèles et envoyez un court message de chat.
La documentation de confidentialité de Cursor mentionne le remplacement de l'URL de base compatible OpenAI. Cursor ne documente pas les étapes exactes. Les libellés de votre version peuvent être différents.
Pour vérifier que les requêtes arrivent à la passerelle, ouvrez le journal des requêtes du tableau de bord. Chaque réponse contient aussi un en-tête X-Routed-Via qui indique le fournisseur et le modèle qui ont répondu.
Étape 3 : choisir les modèles
Utilisez l'identifiant de modèle auto pour laisser le routeur choisir un modèle gratuit pour chaque requête. Vous pouvez aussi utiliser un identifiant du catalogue issu de GET /v1/models. Le chat de Cursor envoie le contexte des fichiers avec chaque message, utilisez donc des modèles à grande fenêtre de contexte. Le tableau indique les modèles gratuits avec appels d'outils et au moins 128K de contexte, aujourd'hui.
| Modèle | Gratuit sur | Contexte | Limites gratuites (meilleure offre) | Outils | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 req/min 1 req/min per model | Oui | Non |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 req/min 40 RPM | Oui | Oui |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Oui | Oui |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Oui | Non |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/jour 50 req/day account-wide (1,000 after a $10 purchase) | Oui | Oui |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/jour Shared rate limit | Oui | Non |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 req/min 250 req/jour 70,000 jetons/min ~6M | Oui | Oui |
Affichage de 10 modèles gratuits sur 109 correspondants. Voir tous les modèles.
Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.
Cursor documente les clés OpenAI personnelles pour les modèles de chat sans raisonnement. Les modèles de raisonnement peuvent échouer avec le remplacement. Si un modèle échoue, utilisez auto ou un autre modèle du tableau.
Limites de débit et basculement
Chaque offre gratuite a des limites par minute et par jour. FreeLLMAPI compte l'usage de chaque clé. Quand un fournisseur renvoie une erreur 429, le routeur envoie la requête au modèle suivant de votre chaîne de repli. Le chat continue, et vous ne modifiez aucun paramètre dans Cursor.
- Ajoutez des clés de quatre fournisseurs ou plus. Plus de fournisseurs donnent plus de requêtes par jour.
- Utilisez
auto:fastpour les questions courtes etauto:smartpour les questions de code difficiles. - Ouvrez un nouveau chat pour chaque tâche. Un historique plus court envoie moins de tokens.
Dépannage
| Problème | Cause | Solution |
|---|---|---|
Cursor ne peut pas se connecter à http://localhost:3001/v1 | Cursor envoie les requêtes depuis ses serveurs, et non depuis votre ordinateur | Utilisez une adresse HTTPS publique pour la passerelle |
| Aucune option pour une clé personnelle | Votre offre Cursor n'inclut pas les clés API personnelles | Consultez le tableau des offres sur la page tarifaire de Cursor |
401 "Invalid API key" | La clé dans Cursor n'est pas votre clé unifiée FreeLLMAPI | Recopiez la clé unifiée depuis la page Keys |
| La complétion Tab n'utilise pas la passerelle | Cursor utilise toujours ses propres modèles pour Tab | Aucune solution. Utilisez Continue dans VS Code pour une complétion gratuite |
| Erreur indiquant que tous les modèles sont limités après N tentatives | Toutes les clés de la chaîne ont atteint leur limite | Ajoutez des clés de plusieurs fournisseurs, ou attendez la fin des pauses |
| Les modèles intégrés ne fonctionnent plus | Le remplacement de l'URL de base est toujours actif | Désactivez le remplacement |
Questions fréquentes
Puis-je utiliser Cursor gratuitement avec ma propre clé API ?
La page tarifaire de Cursor liste les clés API personnelles pour les offres Premium, Super et Ultra, et indique que l'offre Plus n'a pas de clés personnelles. Sur une offre avec clés personnelles, FreeLLMAPI fournit au chat des modèles gratuits, donc le coût d'inférence est de $0.
Pourquoi Cursor ne se connecte-t-il pas à localhost ?
Cursor envoie toutes les requêtes par ses propres serveurs pour construire le prompt. Ces serveurs ne peuvent pas atteindre localhost sur votre ordinateur, la passerelle a donc besoin d'une adresse HTTPS publique.
La complétion automatique Tab de Cursor fonctionne-t-elle avec une API personnalisée ?
Non. La documentation de Cursor indique que les clés API personnalisées ne fonctionnent qu'avec les modèles de chat, et que la complétion Tab continue d'utiliser les modèles intégrés de Cursor.
Quel modèle gratuit est le meilleur pour Cursor ?
Utilisez auto, ou un modèle à appels d'outils avec au moins 128K de contexte, pris dans le tableau de cette page. Cursor envoie le contexte des fichiers avec chaque message, une grande fenêtre de contexte est donc importante.
Mon code est-il envoyé à Cursor quand j'utilise ma propre clé ?
Oui. Cursor indique que les requêtes passent par ses serveurs pour la construction finale du prompt. La Zero Data Retention ne s'applique pas quand vous utilisez vos propres clés.
Guides associés
- Modèles d'IA gratuits dans VS Code
- Cline, Roo Code et Kilo Code avec une API gratuite
- Continue avec une API LLM gratuite
- Meilleures API gratuites de modèles de code
- URL de base des API gratuites compatibles OpenAI
Sources
- Cursor help: API keys (vérifié le 20 November 2026)
- Cursor docs: models and pricing (vérifié le 20 November 2026)
- Cursor docs: privacy and data governance (vérifié le 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (vérifié le 20 November 2026)
- FreeLLMAPI CLI generators (vérifié le 20 November 2026)