Cursor IDE

Подключение Cursor к Model Gate через OpenAI-совместимый API и короткие псевдонимы моделей.

Cursor IDE через Model Gate

Cursor использует OpenAI-совместимый эндпоинт:

https://api.model-gate.com/v1

1. Создать API-ключ

Откройте https://panel.model-gate.com/en/api-keys, создайте ключ и сразу скопируйте его.

2. Настроить Cursor

Откройте Cursor Settings.
Откройте Models или API Keys в зависимости от установленной версии Cursor.
Введите ключ Model Gate в поле OpenAI API key.
Включите переопределение OpenAI Base URL.
Укажите Base URL:

https://api.model-gate.com/v1

Добавьте собственную модель, используя короткий псевдоним Model Gate. Cursor может отклонять или переписывать полные канонические ID, поэтому используйте, например, ch-47 вместо claude-opus-4.7.
Проверьте настройки и начните новый чат.

Собственные API-ключи Cursor применяются к стандартным функциям чат-моделей. Специализированные функции на стороне Cursor могут продолжать использовать инфраструктуру Cursor.

Псевдонимы моделей

В Cursor указывайте псевдоним модели, например ch-47, а не исходный ID вроде claude-opus-4.7. Cursor может отклонять или переписывать полные имена из-за внутренних ограничений на названия моделей. Поэтому Model Gate поддерживает разрешённые псевдонимы.

Ниже перечислены активные псевдонимы:

Псевдоним	Модель
`ch-46`	`claude-opus-4-6`
`ch-46s`	`claude-sonnet-4-6`
`ch-47`	`claude-opus-4-7`
`ch-48`	`claude-opus-4-8`

Пример:

Cursor model: ch-47
Resolved model: claude-opus-4.7

Model Gate разрешает псевдоним перед:

проверкой доступности модели;
применением пользовательских и официальных тарифов;
расчётом стоимости для лимита;
постановкой в асинхронную очередь;
отправкой поставщику;
сохранением истории запроса.

Ответ поставщика может содержать канонический ID модели.

Проверить вне Cursor

curl https://api.model-gate.com/v1/chat/completions \
  -H "Authorization: Bearer mg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ch-47",
    "messages": [{"role": "user", "content": "Reply with OK"}]
  }'

Устранение проблем

Проблема	Решение
Cursor отклоняет длинный ID модели	Используйте активный короткий псевдоним из таблицы ниже. `/v1/models` возвращает только канонические ID.
Ошибка аутентификации	Заново введите ключ Model Gate и проверьте его через curl.
Запросы не доходят до Model Gate	Убедитесь, что Base URL включает `/v1`.
Модель не найдена	Псевдоним может быть отключён или связан с отключённой моделью.
Функция Cursor игнорирует собственный API	Проверьте стандартную чат-модель; не все функции на стороне Cursor поддерживают собственные API-ключи.

Актуальная документация API-ключей Cursor: https://docs.cursor.com/settings/api-keys.