Cursor

Используйте Override OpenAI Base URL в Cursor, чтобы запускать GPT-модели из каталога OneProvider в Ask и Agent.

AI-редактор кода Cursor

Что поддерживается

Запросы Ask и Agent к добавленным GPT model ID идут через OneProvider, включая streaming ApplyPatch. Cursor отправляет их со своих серверов, поэтому работает только публичный endpoint; runtime агента и специальные hosted-функции остаются под управлением Cursor.

Ограничение клиента

Нужен платный план Cursor (Pro или выше): с января 2026 Cursor не использует свои ключи на Free-плане. Override глобальный — пока он включён, все модели, кроме моделей Anthropic и Google, включая собственные GPT, Composer и Grok от Cursor, уходят в OneProvider; чтобы снова пользоваться моделями Cursor, выключите его. Встроенные модели Anthropic/Claude и Google не используют override, а Tab completion и hosted-функции сохраняют обычную маршрутизацию.

Настройка

1. Обновите Cursor и подготовьте отдельный ключ

   Используйте последнюю stable-версию Cursor на плане Pro или выше. Создайте отдельный ключ OneProvider, ограничьте модели и расходы, затем пополните баланс.

2. Включите OpenAI API Key

   Откройте Cursor Settings → Models → API Keys, вставьте отдельный ключ OneProvider в поле OpenAI API Key и включите его переключатель — одной вставки ключа недостаточно.

   OpenAI API Key: sk-your-key-here

3. Замените OpenAI base URL

   Включите Override OpenAI Base URL и укажите ровно https://api.oneprovider.dev/v1 — с /v1 и без /chat/completions: путь Cursor дописывает сам. Cursor требует совместимый OpenAI model ID; выберите ID текстовой GPT-модели из каталога (модель для изображений в чате не подойдёт).

   Override OpenAI Base URL: https://api.oneprovider.dev/v1

4. Сохраните и выберите совместимую модель

   Сохраните OpenAI key и base URL. Если выбранного совместимого model ID нет в списке, добавьте его как custom model и запустите новый Ask или Agent запрос. ID моделей Claude и Google через этот override не идут. Отключите override, когда нужна обычная маршрутизация Cursor.

Проверка подключения

Подтвердите запрос в dashboard

Запрос должен показывать gpt-5.6-terra, OpenAI-compatible endpoint, расход токенов и списание. Если Cursor вместо ответа показывает ошибку:

"does not work with your current plan or api key" → Free-план или выключен переключатель OpenAI API Key
"Model name is not valid" → включите переключатель OpenAI API Key и откройте новый чат
404 / "Invalid URL" → base URL должен быть ровно https://api.oneprovider.dev/v1
401 → неверный, отозванный или не пополненный ключ OneProvider
"model … is not available" → такого model ID нет в каталоге OneProvider
Не работают модели самого Cursor → выключайте Override OpenAI Base URL, пока пользуетесь ими

Параметры подключения

Протокол

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Безопасность ключа

Cursor формирует запрос через свой сервис, поэтому не ограничивайте ключ IP-адресом рабочей станции. Используйте отдельный ключ с model, rate, spend, expiry и scope limits.

Какую модель выбрать

Через override идут только модели в стиле OpenAI, поэтому выбирайте текстовую модель GPT. gpt-5.6-terra это сбалансированный вариант для Ask и Agent. gpt-6.1-sol это топовый уровень для сложных задач по нескольким файлам, gpt-5.6-luna это дешёвый уровень для быстрых вопросов. Добавьте выбранный id как custom model, ровно как в каталоге . Id Claude через этот override не идут: для Claude запускайте Claude Code рядом с Cursor.

Частые ошибки и решения

«Model name is not valid»

Переключатель OpenAI API Key выключен или модель добавили до его включения. Включите переключатель, сохраните и начните новый чат.

«Does not work with your current plan or api key»

У вас тариф Free или переключатель выключен. На Free Cursor игнорирует собственные ключи; нужен Pro или выше.

404 или «Invalid URL»

Введите https://api.oneprovider.dev/v1 ровно так: с /v1, без /chat/completions. Путь Cursor добавляет сам.

401

Ключ неверный, отозван или баланс пуст. Вставьте ключ целиком без пробелов и пополните кабинет.

Собственные модели Cursor не работают, пока включён override

Override глобальный: все модели кроме Anthropic и Google уходят в OneProvider. Выключите Override OpenAI Base URL, чтобы снова пользоваться моделями Cursor.

Запросы не видны в кабинете

Использована модель Claude или Google, либо override выключен. Выберите добавленный GPT id и запустите новый Ask или Agent.

Вопросы и ответы

Затрагивает ли это Tab-автодополнение?

Нет. Tab и сервисы на стороне Cursor работают как обычно.

Можно ли ограничить ключ по IP?

Нет. Cursor шлёт запросы со своих серверов, и белый список IP их заблокирует. Используйте лимиты по моделям, частоте и расходу.

Можно ли использовать Claude в Cursor через OneProvider?

Через этот override нельзя. Для Claude возьмите Claude Code или Cline .

Как вернуть всё обратно?

Выключите Override OpenAI Base URL. Остальные настройки останутся.

Быстрые ответы

Какой base URL использовать?

Claude Code и Anthropic SDK работают с https://api.oneprovider.dev. OpenAI SDK и OpenAI-совместимые клиенты работают с https://api.oneprovider.dev/v1. За обоими адресами один ключ; список моделей: странице моделей , ставки на странице тарифов .

Как авторизоваться?

Передайте сырой ключ sk-… в заголовке x-api-key или Authorization: Bearer: один из двух, не оба. Храните ключ в переменной окружения, а не в файле, который попадает в репозиторий. Подробнее об аутентификации .

Где взять ключ?

Откройте кабинет в Telegram-боте @oneprovider_robot или на app.oneprovider.dev, пополните баланс и нажмите «Выпустить ключ». У каждого ключа может быть свой лимит расхода. Кабинет и ключи .

Что значат ошибки 401, 404 и 429?

401: ключ не задан, написан с ошибкой или передан не в том заголовке; вставьте ключ целиком, без кавычек и пробелов. 404: обычно неверный base URL, например лишний или двойной /v1. 429 с текстом «Insufficient balance»: баланс кабинета или лимит ключа исчерпан, пополните его вместо повторов; любой другой 429 это лимит частоты, подождите Retry-After. Разбор: коды ошибок и решение проблем .

Почему обрывается стрим или сбрасывается соединение?

VPN и VLESS-прокси часто буферизуют SSE или ломают согласование HTTP/2. У OneProvider нет региональных ограничений, и стримы на нашей стороне не буферизуются: отключите прокси и повторите запрос.

Куда писать, если не помогло?

Напишите в Telegram @Oneproviderhelpbot или откройте «Поддержку» в веб-кабинете: приложите код статуса и точный текст ошибки. Как работает поддержка .