Використання Cursor з безкоштовним LLM API
Cursor може надсилати запити чату до вашого власного ключа API OpenAI. Цей посібник показує, як підключити цей ключ до безкоштовних моделей через FreeLLMAPI. Він також пояснює обмеження. Cursor спрямовує кожен запит через свої сервери, а доповнення Tab завжди використовує моделі Cursor.
Код, назви моделей і мітки живого каталогу показано англійською.
Що працює, а що ні
Прочитайте цей розділ, перш ніж почати. Підтримка власних ключів у Cursor вужча, ніж у більшості інших редакторів.
| Функція Cursor | З вашим ключем | Джерело |
|---|---|---|
| Чат зі стандартною моделлю у форматі OpenAI | Так. Cursor документує власні ключі OpenAI для стандартних чат-моделей без міркування. | Довідкова сторінка про ключі API Cursor |
| Доповнення Tab | Ні. Cursor каже, що Tab і далі використовує вбудовані моделі Cursor. | Довідкова сторінка про ключі API Cursor |
| Режим агента і Composer | Не підтверджено. Документація Cursor називає лише чат-моделі. Перевірте на своєму плані, перш ніж покладатися на це. | Не задокументовано |
| Запити з localhost | Ні. Cursor надсилає всі запити через свої сервери для побудови промпту, тому localhost на вашому комп'ютері не є частиною шляху. | Довідкова сторінка про ключі API Cursor |
Плани також важливі. Сторінка цін 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.
- Знайдіть поле ключа API OpenAI. Вставте свій єдиний ключ FreeLLMAPI. Натисніть Save.
- Увімкніть перевизначення базової URL OpenAI. Посібник FreeLLMAPI називає цей параметр Override OpenAI Base URL.
- Введіть свою публічну адресу з
/v1в кінці, наприкладhttps://<your-tunnel-host>/v1. - Виберіть модель у списку моделей і надішліть коротке повідомлення в чаті.
Документація Cursor про конфіденційність згадує перевизначення базової URL, сумісної з OpenAI. Cursor не описує точні кроки. Написи у вашій версії можуть відрізнятися.
Щоб переконатися, що запити доходять до шлюзу, відкрийте журнал запитів на панелі керування. Кожна відповідь також має заголовок X-Routed-Via, який показує провайдера і модель, що відповіли.
Крок 3: виберіть моделі
Використовуйте ідентифікатор моделі auto, щоб маршрутизатор вибирав безкоштовну модель для кожного запиту. Можна також використати ідентифікатор каталогу з 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 |
| «All models rate-limited after N attempts» | Усі ключі в ланцюжку досягли ліміту | Додайте ключі від більшої кількості провайдерів або дочекайтеся охолодження |
| Вбудовані моделі перестають працювати | Перевизначення базової URL досі увімкнене | Вимкніть перевизначення |
Часті запитання
Чи можна використовувати Cursor безкоштовно з власним ключем API?
Сторінка цін Cursor перелічує власні ключі API для планів Premium, Super і Ultra і каже, що в плані Plus немає власних ключів. На плані з власними ключами FreeLLMAPI дає чату безкоштовні моделі, тому вартість інференсу становить $0.
Чому Cursor не підключається до localhost?
Cursor надсилає всі запити через свої сервери для побудови промпту. Ці сервери не можуть дістатися до localhost на вашому комп'ютері, тому шлюзу потрібна публічна адреса HTTPS.
Чи працює автодоповнення Tab у Cursor з власним 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)