Короткий ответ
Для custom OpenAI-compatible API в Cursor держите согласованными три поля: API Key, Base URL и Model ID. API Key авторизует запрос. Base URL определяет provider, куда уходит запрос. Model ID определяет модель. Все три значения должны относиться к одному provider или compatible gateway.Когда это важно
- Вы хотите использовать third-party OpenAI-compatible provider в Cursor
- Нужно задать Override OpenAI Base URL
- Вы добавляете custom model
- Видите model not found или authentication failures
- Хотите, чтобы Cursor, Codex и другие tools использовали один model routing layer
Значение полей
| Поле | Роль |
|---|---|
| API Key | Authentication credential |
| Base URL | OpenAI-compatible endpoint, обычно /v1 URL |
| Model ID | Model identifier, который распознает provider |
| Custom model | Модель, вручную добавленная или выбранная в Cursor |
Рекомендуемые шаги
- Создайте API Key в provider dashboard.
- Добавьте API Key в Cursor model settings.
- Введите provider Base URL в Override OpenAI Base URL.
- Добавьте или выберите Model ID, который поддерживает provider.
- Сохраните и проверьте простым запросом.
Частые ошибки
- API Key от одного provider, а Base URL от другого.
- Claude model name в OpenAI-compatible configuration.
- UI display name вместо API model ID.
- Думать, что Cursor Rules влияют на API authentication.
- Забывать, что global override может влиять на другие OpenAI models.
О LLMEasy
Cursor и похожие external tools обычно используют OpenAI-compatible setup. Base URL LLMEasy —https://www.llmeasy.ru/v1, а model IDs берутся из группы ключа GPT в model plaza.
Не вставляйте Claude Code https://www.llmeasy.ru в Cursor OpenAI-compatible configuration.
Связанные материалы
- Cursor Rules, AGENTS.md и .cursorignore
- Как настроить MCP в Cursor
- OpenAI-compatible API и Anthropic-compatible API
- Что такое model_provider, base_url и wire_api?