CCG API Docs / Cursor
Cursor · интеграция

Cursor с нашим API

Cursor поддерживает переопределение OpenAI Base URL в настройках — этого достаточно, чтобы использовать GPT-модели нашего API в чате и агенте.

Поддерживаемые ключи

Cursor позволяет переопределить только OpenAI-endpoint, поэтому поддерживаются GPT-ключи.

Ваш ключКак подключаетсяBase URLМодель (пример)
GPT (gpt-*)Override OpenAI Base URLhttps://bridge.gptclaudegemini.xyz/v1gpt-5.6-terra
Claude (claude-*)не поддерживается: Cursor не даёт переопределить Anthropic-endpoint
Один ключ — один тип моделей

Ключ видит только модели своего тарифа. Проверить список: GET https://bridge.gptclaudegemini.xyz/v1/models с вашим ключом.

Установка и настройка

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

    Cursor → Settings → Models.

  2. Переопределите OpenAI Base URL

    Override OpenAI Base URLhttps://bridge.gptclaudegemini.xyz/v1
    OpenAI API Keyваш ключ sk-xxxxxxxxxx
  3. Добавьте модель

    Нажмите «+ Add Model» и введите точный ID, например gpt-5.6-terra. Затем нажмите Verify рядом с ключом.

Ограничение Cursor

Собственные функции Cursor (Tab-автодополнение, Composer с фирменными моделями) продолжают работать через аккаунт Cursor. Через custom Base URL работает чат и агент с вашей моделью.

Выбор модели

Доступные model ID зависят от вашего ключа:

Terminal
curl https://bridge.gptclaudegemini.xyz/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

Решение проблем

Invalid API Key / 401
Проверьте, что ключ скопирован целиком и без пробелов, а Base URL указан точно как в таблице выше.
Model Not Found
Запросите список моделей вашего ключа через /v1/models и используйте точный ID из ответа.
Первый запрос упал с 5xx, повтор прошел
При недоступности одного upstream шлюз переключается на резервный, но первая попытка может вернуть ошибку. Повторите запрос.
Verify выдает ошибку
Убедитесь, что Base URL оканчивается на /v1, ключ имеет GPT-доступ, а модель добавлена с точным ID.

Статистика и ключ

Статистика открывается на отдельном сервисе. Для поиска используйте полный токен; в интерфейсе отображается только маскированная часть ключа.