Cursor

Для Cursor пока удобнее опираться на ручную UI-настройку: ключ вводится через интерфейс редактора, без правки конфигов вручную.

У Cursor UI и внутренняя схема хранения настроек могут меняться чаще, чем у CLI-клиентов. Поэтому здесь удобнее держать понятную пошаговую инструкцию, а не привязываться к внутреннему формату хранения настроек.

Что важно понять заранее

для ручного выбора конкретной модели через свой API key в Cursor нужен платный план Pro или выше; на Free плане у тебя может остаться только Auto
Auto, Tab, Apply и часть agent-функций не являются хорошей проверкой именно нашего endpoint path: даже при включенном BYOK они продолжают зависеть от инфраструктуры и логики самого Cursor
для этой интеграции ориентируйся на явный выбор OpenAI-compatible модели в новом чате, а не на Auto
в текущем Cursor путь через Override OpenAI Base URL относится к OpenAI-compatible семейству; не рассчитывай, что этот же маршрут автоматически проведет claude-* модели

Что использует Cursor

Cursor в этом сценарии настраивается как OpenAI-compatible клиент с базовым URL:

https://apikey.center/v1

Что понадобится

установленный Cursor
план Cursor Pro или выше, если хочешь вручную выбирать модель через свой key
API key от apikey.center
хотя бы один model ID, который уже виден через GET /v1/models
актуальная версия Cursor; для gpt-5.5 с custom endpoint лучше держать 3.5.38+
доступ к экрану настроек моделей или external providers в твоей текущей сборке Cursor

Ручная настройка

1. Открой настройки моделей

В актуальных сборках Cursor начни с раздела примерно такого вида:

Settings -> Models

Если UI немного изменился, ищи страницу, где вводятся external API keys и custom model endpoints.

Практически чаще всего нужно искать одно из таких мест:

Settings -> Models
Settings -> AI
Settings -> Providers
экран, где есть OpenAI API Key, Base URL или Custom Endpoint

Если сразу не видишь нужный раздел, проще всего воспользоваться поиском по настройкам и искать по словам:

OpenAI
Base URL
Model
API key

2. Добавь API key в OpenAI-compatible слот

Введи ключ apikey.center в поле для OpenAI-compatible API key.

На этом шаге важно не смешивать сразу несколько провайдеров. Для первой проверки лучше использовать:

один ключ
один base URL
одну тестовую модель

Так потом проще понять, проблема именно в ключе, в URL или уже в конкретной модели.

Если у тебя одновременно включены и OpenAI API Key, и Anthropic API Key, для первого теста apikey.center лучше временно оставить только OpenAI-compatible сценарий. Так проще увидеть, действительно ли запрос уходит в наш endpoint, а не в другую встроенную ветку Cursor.

3. Включи custom base URL

Если в твоей сборке Cursor есть переключатель вроде:

Override OpenAI Base URL

включи его и поставь:

https://apikey.center/v1

Если UI просит именно OpenAI Base URL, всё равно указывай полный OpenAI-compatible base URL:

https://apikey.center/v1

Для Cursor не нужно ставить корневой адрес без /v1, потому что это не Anthropic-style сценарий, а именно OpenAI-compatible.

4. Выбери правильный первый model ID

Для первого подключения не пытайся сразу включить все кастомные модели. Лучше взять один понятный сценарий и проверить только его.

Хороший порядок такой:

сначала обновить Cursor, если версия старая
потом проверить GET /v1/models
выбрать один конкретный OpenAI-compatible model ID
открыть новый пустой чат
сделать самый короткий тестовый запрос

Для gpt-5.5 есть отдельная важная деталь:

не пытайся создавать отдельный custom model с именем gpt-5.5
включи OpenAI API Key и Override OpenAI Base URL
затем выбери встроенную модель GPT-5.5 в UI
на backend уйдет internal ID gpt-5.5

Для claude-opus-4-8 в этой странице логика другая:

не пытайся проводить его через Override OpenAI Base URL
Cursor относит claude-* к Anthropic family
в этой инструкции не рассматривается маршрут для claude-opus-4-8, потому что этот путь построен вокруг OpenAI-compatible endpoint https://apikey.center/v1

Если базовый OpenAI-compatible сценарий проходит, потом уже можно добавлять остальные модели этого же семейства.

5. Перезапусти чат или редактор

Если после сохранения интерфейс не перечитал настройку, открой новый чат или полностью перезапусти Cursor.

Если поведение осталось старым, лучше сделать именно полный restart приложения, а не только закрыть вкладку чата.

На Windows это особенно важно: иногда UI-закрытие не сбрасывает все фоновые процессы редактора.

6. Проверь настройку отдельно от Cursor, если есть сомнения

Если непонятно, проблема в API или в самом Cursor, сделай внешний тест до повторной попытки в UI.

macOS / Linux:

curl https://apikey.center/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Windows PowerShell:

Invoke-WebRequest `
  -Uri "https://apikey.center/v1/models" `
  -Headers @{ Authorization = "Bearer YOUR_API_KEY" }

Если этот запрос проходит, значит домен и ключ уже в целом рабочие, и искать проблему нужно в UI-настройке Cursor.

Автонастройка

Отдельного скрипта автонастройки для Cursor пока нет. Когда он появится, команда будет такой:

curl -fsSL https://docs.apikey.center/i/cursor.sh | sh

Но текущая рабочая документация для релиза должна оставаться UI-first и не зависеть от внутреннего формата хранения ключей Cursor.

Verification

Cursor сохраняет custom base URL без ошибок
если в UI есть кнопка проверки соединения, используй ее
тестируй не Auto, а явно выбранную модель
новый чат должен проходить без ошибки некорректного endpoint
при неверном ключе должна быть ошибка авторизации, а не ошибка invalid URL
если модель не отвечает, сначала проверь сам model ID и только потом base URL
для gpt-5.5 сначала проверь, что Cursor обновлен хотя бы до 3.5.38+

Успешный сценарий выглядит так:

GET /v1/models руками работает
Cursor принимает https://apikey.center/v1
в UI выбрана конкретная модель, а не Auto
новый чат стартует без route-error
ответ приходит именно через выбранную модель

Rollback

очисти введенный API key
выключи override/custom base URL
удали или отключи кастомную модель, которую добавлял для apikey.center
перезапусти Cursor

Если ты до этого уже использовал другой кастомный endpoint, верни именно прошлые значения, а не просто очищай поля наугад.

Частые ошибки

Вставили `https://apikey.center` без `/v1`

Для Cursor это обычно неправильный вариант. В этой инструкции Cursor настраивается как OpenAI-compatible клиент и должен использовать:

https://apikey.center/v1

Добавили сразу много моделей и непонятно, что сломалось

Для первой проверки лучше подключать только один model ID. Иначе сложнее понять, где именно ошибка: в auth, в URL или в конкретной модели.

На Free плане не удается выбрать модель через свой key

Это ожидаемое ограничение Cursor. Для ручного выбора конкретной модели в BYOK-сценарии нужен Pro или выше. На Free плане не используй эту страницу как proof, что наш endpoint сломан: сначала проверь тариф и наличие обычного model picker.

`gpt-5.5` не доходит до `apikey.center`

Сначала проверь версию Cursor. Для нормального BYOK-сценария с GPT-5.5 и Override OpenAI Base URL нужен актуальный редактор; безопасный ориентир для этой инструкции — 3.5.38+.

Также не пытайся создать отдельный custom model с именем gpt-5.5. В актуальном Cursor это built-in model ID, и для него нужно выбирать встроенную GPT-5.5, а не дублировать ее вручную.

Пытаются провести `claude-opus-4-8` через `OpenAI Base URL`

Это не тот маршрут. В Cursor claude-* относится к Anthropic family, а Override OpenAI Base URL покрывает OpenAI-compatible ветку. В этой инструкции claude-opus-4-8 внутри этого конкретного Cursor-сценария не рассматривается.

Старый чат продолжает вести себя странно

После смены провайдера лучше открывать новый пустой чат. Иногда старый чат продолжает жить с уже закешированными параметрами.

Видна URL-ошибка вместо auth-ошибки

Обычно это значит, что проблема не в ключе, а в base URL или в формате кастомного endpoint.

Практические замечания

С чего начинать тест

Лучше начинать с самого простого сценария:

Cursor Pro
один key
один base URL
одна явно выбранная модель
новый пустой чат

Так проще понять, сломался ли именно auth, конкретная модель или сама UI-настройка.

Что не стоит делать в первой проверке

Не смешивай сразу несколько кастомных endpoint-ов и несколько новых моделей. Для первой проверки это только усложнит диагностику.