CCGAPI Docs/ Route API
API Reference

Route API

OpenAI-compatible API для Chat Completions, Responses и интеграций, в которых можно указать собственный base URL.

Отправить первый запросНастроить Codex

Обзор

Базовый URL: https://route.gptclaudegemini.xyz. Клиент получает только наш API key. Ключи и credentials upstream providers не передаются пользователю.

Codex использует отдельную проверенную конфигурацию

Основная инструкция Codex указывает на https://bridge.gptclaudegemini.xyz/. Не заменяйте этот URL на Route API без подтверждения продукта и доступных моделей.

Авторизация

Передавайте клиентский ключ в стандартном Bearer header:

HTTP header
Authorization: Bearer sk-xxxxxxxxxx
Content-Type: application/json
Не передавайте ключ в query string

URL может попасть в историю браузера, access logs и аналитику. Используйте только header или защищенное поле API key в клиенте.

Endpoints

GET/v1/modelsМодели, доступные группе вашего ключа.
POST/v1/chat/completionsСтандартный OpenAI-compatible chat.
POST/v1/responsesResponses API для совместимых agent clients.
BASE/v1thinking/Отдельный base URL для reasoning clients, включая Roo Code сценарии.

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

Сначала запросите список моделей, затем используйте точный ID из ответа.

GET /v1/models
curl https://route.gptclaudegemini.xyz/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxx"
POST /v1/chat/completions
curl https://route.gptclaudegemini.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID_FROM_V1_MODELS",
    "messages": [{"role": "user", "content": "Reply with OK"}],
    "stream": false
  }'

Совместимые клиенты

Используйте тип provider, соответствующий протоколу клиента.

СценарийProviderBase URL
OpenAI SDK и generic clientsOpenAI Compatiblehttps://route.gptclaudegemini.xyz/v1
Reasoning в Roo CodeOpenAI Compatiblehttps://route.gptclaudegemini.xyz/v1thinking/
Responses-compatible agentsOpenAI Responseshttps://route.gptclaudegemini.xyz/v1

Диагностика

401 Unauthorized
Проверьте Bearer header и отсутствие пробелов в ключе. Не добавляйте ключ в URL.
404 или model not found
Запросите /v1/models с тем же ключом и используйте ID из ответа. Модель может не входить в группу продукта.
Клиент не поддерживает custom base URL
Такой клиент нельзя подключить напрямую. Нужна версия с custom provider или отдельный adapter. Не подменяйте системный DNS и не встраивайте ключ в frontend bundle.
Потоковый ответ обрывается
Проверьте поддержку SSE и timeout в клиенте. Повторите запрос с "stream": false, чтобы отделить проблему streaming от авторизации или модели.