Как подключить Cursor к Tokenator API

Что получится в итоге

После настройки Cursor перестаёт обращаться к своему стандартному провайдеру и отправляет все запросы в Tokenator. Оплата идёт токенами вашего ключа, а список доступных моделей задаётся ключом, а не инструментом.

Требования и поддерживаемые ОС

• Windows 10/11, macOS 12+ или современный Linux с 64-битной архитектурой.
• Доступ в интернет к домену Tokenator по HTTPS.
• API-ключ Tokenator вида sk-your-tokenator-key.

Нужна установленная десктопная сборка Cursor. Настройка выполняется в интерфейсе, файлы править не требуется.

Установка Cursor

Скачайте и установите Cursor с официального сайта проекта, затем войдите в аккаунт — без него раздел настроек моделей недоступен.

Настройка Tokenator

1. Зарегистрируйтесь в личном кабинете и купите пакет токенов.
2. Ключ появится в кабинете сразу после подтверждения оплаты — копировать его нужно целиком, вместе с префиксом.
3. В примерах ниже вместо настоящего ключа стоит плейсхолдер sk-your-tokenator-key. Не публикуйте настоящий ключ в репозиториях и скриншотах.

Конфигурация для Windows

1. Откройте Settings → Models.
2. В разделе ключей OpenAI включите Override OpenAI Base URL и укажите https://api.tokenator.top/v1.
3. В поле ключа вставьте sk-your-tokenator-key.
4. Добавьте нужную модель в список моделей вручную — ID берите из каталога, например gpt-5.5.
5. Нажмите проверку ключа и сохраните настройки.

Конфигурация для macOS и Linux

1. Откройте Settings → Models.
2. В разделе ключей OpenAI включите Override OpenAI Base URL и укажите https://api.tokenator.top/v1.
3. В поле ключа вставьте sk-your-tokenator-key.
4. Добавьте нужную модель в список моделей вручную — ID берите из каталога, например gpt-5.5.
5. Нажмите проверку ключа и сохраните настройки.

Первый запрос

Перед запуском инструмента полезно убедиться, что ключ и модель рабочие. Один запрос curl отвечает на оба вопроса сразу.

curl https://api.tokenator.top/v1/chat/completions \
  -H "Authorization: Bearer sk-your-tokenator-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "ping"}]
  }'

Откройте проект в редакторе и отправьте любое сообщение в чат расширения. Если запрос дошёл, он появится в статистике ключа в личном кабинете.

Успешный ответ означает, что ключ действителен, модель разрешена для этого ключа и апстрим доступен. Расход виден в кабинете сразу после запроса.

Переключение моделей

Модель указывается полем Model ID в настройках провайдера. Base URL и ключ при смене модели менять не нужно.

Примеры ID моделей, доступных сейчас:

• claude-haiku-4-5
• claude-opus-4-6
• claude-opus-4-7
• claude-sonnet-4-6
• gpt-5.5
• deepseek-v4-flash

Актуальные ID и характеристики — в каталоге AI-моделей; там же видно, какие модели сейчас доступны. Выбрать между близкими вариантами помогает сравнение моделей.

Настройка reasoning

Если инструмент умеет передавать поле reasoning_effort в запросе, Tokenator пробрасывает его в апстрим без изменений. Дополнительно у самого ключа есть переключатель reasoning в личном кабинете — он действует независимо от инструмента.

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

Частые вопросы

Читайте дальше