Cursor IDE

Cursor — AI-редактор на базе VS Code. Подключается к AITUNNEL через Override OpenAI Base URL: один ключ sk-aitunnel-, российский домен, оплата в рублях.

Base URL для Cursor — https://api.aitunnel.ru/v1/cursor.

Зачем через AITUNNEL

• Из России без VPN. Запросы идут на api.aitunnel.ru, зарубежная карта и аккаунт не нужны.
• Оплата в рублях, бюджет на ключе, расход в панели.
• Любая модель из каталога через один ключ — Kimi, Qwen, GPT, Claude, Gemini, DeepSeek.
• Agent Mode на gpt-*. Наш эндпоинт /v1/cursor понимает формат запросов, который Cursor шлёт для моделей OpenAI — см. как это работает.

Быстрый старт

1. Ключ

   Создайте ключ в панели ключей — он начинается с sk-aitunnel-. Баланс должен быть положительным.

2. Настройки Cursor

   Откройте Cursor Settings (Cmd/Ctrl + ,) → Models → раздел API Keys:

   Поле	Значение
   OpenAI API Key	включить тумблер, вставить sk-aitunnel-xxx
   Override OpenAI Base URL	включить тумблер
   Base URL	https://api.aitunnel.ru/v1/cursor

   

3. Модели

   В поле Add or search model добавьте id в формате провайдер/модель и нажмите Add. Затем включите модель тумблером:

   Id	Зачем
   moonshotai/kimi-k2.6	рекомендуем как основную
   qwen/qwen3-coder-next	open-source альтернатива
   openai/gpt-5.5	флагман OpenAI
   anthropic/claude-sonnet-4.6	флагман Anthropic
   google/gemini-3.5-flash	быстрая, для Cmd+K
   deepseek/deepseek-v4-flash	экономичная reasoning-модель

   

   Актуальный список — на странице моделей. После добавления модели появятся в чате (Cmd+L), Cmd+K и Agent Mode.

   

   Проверить эндпоинт можно и без Cursor — этот запрос повторяет формат, который шлёт сам редактор:

   cURL

   curl https://api.aitunnel.ru/v1/cursor/chat/completions \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer sk-aitunnel-xxx" \
     -d '{
       "model": "openai/gpt-5.5",
       "input": [
         { "role": "user", "content": [{ "type": "input_text", "text": "Привет" }] }
       ],
       "max_output_tokens": 32
     }'

   В ответ придёт обычный chat.completion с usage.cost_rub.

Как это работает

Cursor всегда шлёт запросы на /chat/completions, но формат тела выбирает по имени модели. Для id, похожих на модели OpenAI (gpt-*, o3), он отправляет payload Responses API: input вместо messages, плоские определения инструментов, max_output_tokens вместо max_tokens. Обычный OpenAI-совместимый эндпоинт такое тело отклоняет с ошибкой Input required: specify "prompt" or "messages" — поэтому gpt-* через кастомный Base URL исторически не работали.

Cursor отправляет:

{
  "model": "openai/gpt-5.5",
  "instructions": "You are an AI coding assistant...",
  "input": [
    { "role": "user", "content": [{ "type": "input_text", "text": "Почини баг" }] }
  ],
  "tools": [
    { "type": "function", "name": "read_file", "parameters": { "…": "…" } }
  ],
  "store": false,
  "max_output_tokens": 8192
}

Запросы с Base URL https://api.aitunnel.ru/v1/cursor уходят на эндпоинт, который понимает форматы Cursor и отвечает обычным chat.completion. Остальное не меняется: тот же ключ, тот же каталог моделей, фолбэки, тарификация и usage.cost_rub в ответе.

Конвертировать ответ не нужно — Cursor получает ровно тот формат, которого ждёт.

Формат Cursor меняет по семейству модели — для gpt-* это Responses API, для claude-* и gemini-* свои варианты. Поэтому на /v1/cursor тело не разбирается: запрос уходит на эндпоинт, который умеет все эти форматы.

Что работает

Предупреждение «Limited support for Agent Mode» Cursor показывает почти для всех моделей на кастомном Base URL. Само по себе оно ни о чём не говорит — проверяйте по факту.

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

• moonshotai/kimi-k2.6 — сильный tool use, заметно дешевле Claude и GPT.
• qwen/qwen3-coder-next — open-source агентная модель.
• openai/gpt-5.5, anthropic/claude-sonnet-4.6 — флагманы для сложных задач.
• google/gemini-3.5-flash — быстрая и дешёвая, удобна для Cmd+K.

Id пишутся в формате провайдер/модель, например moonshotai/kimi-k2.6. На выбор формата запроса в самом Cursor это не влияет — он смотрит только на то, есть ли в имени gpt, claude или gemini.

Расход

Каждый ответ содержит usage.cost_rub — списанную сумму в рублях, и usage.balance — остаток. История запросов и расход по моделям — в панели. Лимит на конкретный ключ ставится в панели ключей.

Agent Mode отправляет весь контекст на каждом шаге, поэтому один запрос пользователя может стоить нескольких обращений к модели. Для больших репозиториев это заметно — начните с дешёвой модели.

Устранение неполадок

• Модели не отвечают. Ключ активен в панели ключей и начинается с sk-aitunnel-, баланс положительный, тумблер Override OpenAI Base URL включён, Base URL — https://api.aitunnel.ru/v1/cursor без слеша в конце.
• Input required: specify "prompt" or "messages". В Base URL потерялся /cursor. Проверьте curl-запросом выше.
• Model not found / 404. Сверьте id со списком моделей — в Cursor нужен формат провайдер/модель, например moonshotai/kimi-k2.6. После добавления моделей перезапустите Cursor.
• 402. Недостаточно средств или исчерпан бюджет ключа — пополните баланс.
• Ошибки tool calling в Agent Mode. Чаще всего Base URL без /cursor: на нём Cursor-форматы не разбираются.
• Tab autocomplete не использует AITUNNEL. Так и должно быть: Tab и Apply идут через подписку Cursor и к кастомному Base URL не подключаются.
• Нет ответа на длинных запросах. В Cursor Settings → Network переключите HTTP Compatibility Mode на HTTP/1.1.

Смотрите также

• Страница инструмента
• API-ключи
• Список моделей
• Вызов инструментов
• Запасные модели
• VS Code
• Claude Code
• Codex CLI
• Документация Cursor