Cursor с бесплатным LLM API
Cursor может отправлять запросы чата на ваш ключ OpenAI API. Это руководство показывает, как подключить этот ключ к бесплатным моделям через FreeLLMAPI. Здесь также описаны ограничения. Cursor направляет каждый запрос через свои серверы, а автодополнение Tab всегда использует модели Cursor.
Код, названия моделей и метки живого каталога показаны на английском языке.
Что работает, а что нет
Прочитайте этот раздел перед началом. Поддержка собственных ключей в Cursor уже, чем в большинстве других редакторов.
| Функция Cursor | С вашим ключом | Источник |
|---|---|---|
| Чат со стандартной моделью в формате OpenAI | Да. Cursor документирует собственные ключи OpenAI для стандартных чат моделей без рассуждений. | Справка Cursor о ключах API |
| Автодополнение Tab | Нет. Cursor пишет, что Tab продолжает использовать встроенные модели Cursor. | Справка Cursor о ключах API |
| Режим агента и Composer | Не подтверждено. В документации Cursor названы только чат модели. Проверьте на своем плане, прежде чем на это полагаться. | Не описано в документации |
| Запросы с localhost | Нет. Cursor отправляет все запросы через свои серверы для сборки промпта, поэтому localhost на вашем компьютере в этот путь не входит. | Справка Cursor о ключах API |
Важны также планы. На странице цен Cursor указаны сторонние модели и собственные ключи API для планов Premium, Super и Ultra. Там сказано, что у плана Plus собственных ключей API нет. Для плана Free страница указывает сторонние модели как недоступные. Прежде чем продолжить, проверьте страницу цен для вашего плана.
localhost напрямую. Читайте статью Cline, Roo Code и Kilo Code с бесплатным API.Шаг 1: установите FreeLLMAPI и сделайте его доступным
FreeLLMAPI имеет открытый исходный код и работает на вашем компьютере в Docker. Установите его, затем добавьте не менее двух бесплатных ключей провайдеров на странице Keys.
Установка на macOS или Linux
curl -fsSL https://freellmapi.co/install.sh | bashСкопируйте единый ключ со страницы Keys. Затем дайте шлюзу публичный адрес HTTPS, потому что серверы Cursor не могут обратиться к вашему localhost. Используйте доверенный туннель HTTPS или сервер, которым вы управляете. Руководство FreeLLMAPI для Cursor выводит эти шаги:
Вывод руководства по Cursor
npx freellmapi setup-cursorЭта команда не записывает файлов. У Cursor нет конфигурационного файла для этой настройки, поэтому значения вводятся в настройках Cursor.
Authorization, создайте отдельный отзываемый токен URL в разделе Keys, Agents. Отзовите его, когда закончите работу.Шаг 2: задайте ключ и базовый URL в Cursor
- Откройте Cursor Settings.
- Откройте Models.
- Найдите поле OpenAI API key. Вставьте ваш единый ключ FreeLLMAPI. Нажмите Save.
- Включите переопределение базового URL OpenAI. В руководстве FreeLLMAPI эта настройка называется Override OpenAI Base URL.
- Введите ваш публичный адрес с
/v1в конце, напримерhttps://<your-tunnel-host>/v1. - Выберите модель в списке моделей и отправьте короткое сообщение в чат.
В документации Cursor о конфиденциальности упоминается переопределение базового URL, совместимого с OpenAI. Точные шаги Cursor не описывает. Подписи в вашей версии могут отличаться.
Чтобы убедиться, что запросы приходят в шлюз, откройте журнал запросов на панели управления. Каждый ответ также содержит заголовок X-Routed-Via, который показывает провайдера и модель, которые ответили.
Шаг 3: выберите модели
Используйте ID модели auto, чтобы маршрутизатор выбирал бесплатную модель для каждого запроса. Также можно использовать ID из каталога через GET /v1/models. Чат Cursor отправляет контекст файлов с каждым сообщением, поэтому используйте модели с большим окном контекста. В таблице показаны бесплатные модели с вызовом инструментов и контекстом не менее 128K на сегодня.
| Модель | Бесплатно в | Контекст | Бесплатные лимиты (лучшее предложение) | Инструменты | Зрение |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 запр./мин 1 req/min per model | Да | Нет |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 запр./мин 40 RPM | Да | Да |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Да | Да |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Да | Нет |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Да | Да |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 запр./мин 20 запр./день 250,000 токенов/мин ~3M | Да | Да |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Да | Да |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 запр./мин 50 запр./день 50 req/day account-wide (1,000 after a $10 purchase) | Да | Да |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 запр./мин 50 запр./день Shared rate limit | Да | Нет |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 запр./мин 250 запр./день 70,000 токенов/мин ~6M | Да | Да |
Показано 10 из 109 подходящих бесплатных моделей. Смотреть все модели.
Актуальные данные из каталога FreeLLMAPI (версия 2026.11.19, проверено 2026-11-19). Бесплатные лимиты часто меняются. Каталог проверяется каждый день.
Cursor документирует собственные ключи OpenAI для чат моделей без рассуждений. Модели с рассуждениями через переопределение могут не работать. Если модель не работает, используйте auto или другую модель из таблицы.
Лимиты запросов и переключение
У каждого бесплатного тарифа есть лимиты в минуту и в день. FreeLLMAPI считает использование каждого ключа. Когда провайдер присылает ошибку 429, маршрутизатор отправляет запрос следующей модели в вашей цепочке переключения. Чат продолжается, и вам не нужно менять настройки в Cursor.
- Добавьте ключи от четырех или более провайдеров. Больше провайдеров дают больше запросов в день.
- Используйте
auto:fastдля коротких вопросов иauto:smartдля сложных вопросов по коду. - Начинайте новый чат для каждой задачи. Короткая история отправляет меньше токенов.
Устранение неполадок
| Проблема | Причина | Решение |
|---|---|---|
Cursor не может подключиться к http://localhost:3001/v1 | Cursor отправляет запросы со своих серверов, а не с вашего компьютера | Используйте публичный адрес HTTPS для шлюза |
| Нет опции для собственного ключа | Ваш план Cursor не включает собственные ключи API | Проверьте таблицу планов на странице цен Cursor |
401 "Invalid API key" | Ключ в Cursor это не ваш единый ключ FreeLLMAPI | Скопируйте единый ключ со страницы Keys еще раз |
| Tab не использует шлюз | Cursor всегда использует свои модели для Tab | Исправления нет. Для бесплатного автодополнения используйте Continue в VS Code |
| "Все модели достигли лимита после N попыток" | Все ключи в цепочке достигли лимита | Добавьте ключи от большего числа провайдеров или дождитесь окончания пауз |
| Встроенные модели перестали работать | Переопределение базового URL все еще включено | Выключите переопределение |
Часто задаваемые вопросы
Могу ли я пользоваться Cursor бесплатно со своим ключом API?
На странице цен Cursor собственные ключи API указаны для планов Premium, Super и Ultra, а для плана Plus там сказано, что собственных ключей нет. На плане с собственными ключами FreeLLMAPI дает чату бесплатные модели, поэтому стоимость вывода равна $0.
Почему Cursor не подключается к localhost?
Cursor отправляет все запросы через свои серверы для сборки промпта. Эти серверы не могут обратиться к localhost на вашем компьютере, поэтому шлюзу нужен публичный адрес HTTPS.
Работает ли автодополнение Cursor Tab с собственным API?
Нет. В документации Cursor сказано, что собственные ключи API работают только с чат моделями, а автодополнение Tab продолжает использовать встроенные модели Cursor.
Какая бесплатная модель лучше всего подходит для Cursor?
Используйте auto или модель с вызовом инструментов и контекстом не менее 128K из таблицы на этой странице. Cursor отправляет контекст файлов с каждым сообщением, поэтому большое окно контекста важно.
Отправляется ли мой код в Cursor, если я использую собственный ключ?
Да. Cursor пишет, что запросы проходят через его серверы для окончательной сборки промпта. Режим Zero Data Retention не действует, когда вы используете собственные ключи.
Похожие руководства
- Бесплатные модели ИИ в VS Code
- Cline, Roo Code и Kilo Code с бесплатным API
- Continue с бесплатным LLM API
- Лучшие бесплатные API моделей для кода
- Базовые URL бесплатных API, совместимых с OpenAI
Источники
- Cursor help: API keys (проверено 20 November 2026)
- Cursor docs: models and pricing (проверено 20 November 2026)
- Cursor docs: privacy and data governance (проверено 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (проверено 20 November 2026)
- FreeLLMAPI CLI generators (проверено 20 November 2026)