Accueil / Guides / Utiliser Cursor avec une API LLM gratuite

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 CursorAvec votre propre cléSource
Chat avec un modèle de type OpenAI standardOui. 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 TabNon. 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 ComposerNon 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 localhostNon. 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.

Remarque : si vous voulez un agent d'éditeur gratuit sans règles d'offre, utilisez Cline, Roo Code ou Kilo Code dans VS Code. Ils se connectent directement à 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 | bash

Copiez 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-cursor

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

Sécurité : une URL publique permet à quiconque possède votre clé unifiée d'utiliser vos quotas gratuits. Ne partagez jamais la clé. Si votre tunnel ne peut pas envoyer d'en-tête 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

  1. Ouvrez Cursor Settings.
  2. Ouvrez Models.
  3. Repérez le champ de clé API OpenAI. Collez votre clé unifiée FreeLLMAPI. Cliquez sur Save.
  4. Activez le remplacement de l'URL de base OpenAI. Le guide FreeLLMAPI nomme ce réglage Override OpenAI Base URL.
  5. Saisissez votre adresse publique avec /v1 à la fin, par exemple https://<your-tunnel-host>/v1.
  6. 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.

Important : le remplacement est global tant qu'il est actif. Désactivez-le avant de revenir aux fournisseurs intégrés de Cursor.

É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èles gratuits pour le chat Cursor : appels d'outils et 128K+ de contexte
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
OuiNon
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
OuiOui
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaOuiOui
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceOuiNon
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditOuiOui
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditOuiOui
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/jour
50 req/day account-wide (1,000 after a $10 purchase)
OuiOui
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/jour
Shared rate limit
OuiNon
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/jour
70,000 jetons/min
~6M
OuiOui

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:fast pour les questions courtes et auto:smart pour les questions de code difficiles.
  • Ouvrez un nouveau chat pour chaque tâche. Un historique plus court envoie moins de tokens.

Dépannage

ProblèmeCauseSolution
Cursor ne peut pas se connecter à http://localhost:3001/v1Cursor envoie les requêtes depuis ses serveurs, et non depuis votre ordinateurUtilisez une adresse HTTPS publique pour la passerelle
Aucune option pour une clé personnelleVotre offre Cursor n'inclut pas les clés API personnellesConsultez 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 FreeLLMAPIRecopiez la clé unifiée depuis la page Keys
La complétion Tab n'utilise pas la passerelleCursor utilise toujours ses propres modèles pour TabAucune solution. Utilisez Continue dans VS Code pour une complétion gratuite
Erreur indiquant que tous les modèles sont limités après N tentativesToutes les clés de la chaîne ont atteint leur limiteAjoutez des clés de plusieurs fournisseurs, ou attendez la fin des pauses
Les modèles intégrés ne fonctionnent plusLe remplacement de l'URL de base est toujours actifDésactivez le remplacement
Utilisez chacun de ces modèles avec une seule clé. FreeLLMAPI est un routeur open source auto-hébergé. Il place toutes ces offres gratuites derrière un seul point de terminaison compatible OpenAI, et bascule vers une autre offre lorsqu'une limite de débit est atteinte. Parcourir le catalogue ou passer en production.

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

Sources

Tous les guides · Parcourir tous les modèles gratuits