Route API

Документация подключения к Route API

Единая инструкция для новой линейки моделей: OpenAI-compatible Chat Completions, Responses API, Claude Code, Codex CLI, Roo Code и Gemini/OpenRouter-compatible клиенты.

Get Started

Запуск за несколько минут

Порядок такой же простой: получите ключ, возьмите готовый пример, отправьте запрос. Upstream-ключи NanoGPT или других источников клиентам не выдаются.

1

Create API Key

Ключ создается в CRM и автоматически привязывается к нужной группе моделей в Route/NewAPI.

2

Use Our Examples

Скопируйте пример для OpenAI-compatible API или готовую настройку для IDE.

3

Make Requests

Все запросы идут на наш Route endpoint, а расход и доступ к моделям учитываются на нашей стороне.

Live examples. Измените ключ, домен или model id здесь - все snippets ниже обновятся автоматически.
Quick Start

Try it with cURL

Первый smoke test: запросить обычный OpenAI-compatible chat completion.

POST /v1/chat/completions

          
Reasoning clients. Для Roo Code используйте отдельный base URL /v1thinking/. Для Codex CLI используйте Responses API и wire_api = "responses".
API Reference

Основные endpoint'ы

Для MVP фиксируем только чистые OpenAI-compatible и Anthropic-compatible сценарии. MCP, x402, scraping, voice, video и image generation здесь не описываем.

Models GET

Список моделей, доступных вашему ключу и группе.

curl

              
Chat Completions POST

Базовый формат для OpenAI-compatible клиентов.

curl

              
Responses API POST

Нужен для Codex CLI и клиентов, которые работают через Responses API.

curl

              
Anthropic-compatible BASE

Для Claude Code задайте Anthropic base URL на наш /v1 и используйте CRM key как auth token.

env

              
One-Click Setup

Скрипт установки

Скрипт настраивает Codex CLI и Claude Code, а для Roo Code и Gemini/OpenRouter-compatible печатает точные значения. Перед запуском можно открыть файл и проверить содержимое.

macOS / Linux

bash

              

Windows PowerShell

powershell

              
Integrations

Подключение IDE и CLI

Каждый блок идет в одинаковом формате: установить, настроить, запустить. Это отдельная линейка от старого bridge endpoint.

Claude Code

ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN.

Codex CLI

base_url на /v1 и wire_api = "responses".

Roo Code

Provider OpenAI Compatible, Base URL на /v1thinking/.

Gemini CLI

OpenRouter-compatible fork/client через OPENROUTER_BASE_URL.

Integration

Claude Code

Claude Code подключается как Anthropic-compatible клиент. Base URL указывает на Route /v1, token - это ваш CRM API key.

1

Install Claude Code

Если Claude Code уже установлен, переходите к настройке окружения.

npm
2

Configure environment

Можно задать переменные в terminal или сохранить их в ~/.claude/settings.json.

macOS / Linux
Windows PowerShell
settings.json
3

Run Claude Code

Откройте проект и запустите CLI.

terminal
Integration

Codex CLI

Codex CLI используем через OpenAI Responses API. В config нужен provider с wire_api = "responses".

1

Install Codex CLI

Если Codex уже установлен, этот шаг можно пропустить.

npm
2

Create config.toml

Файл хранится в ~/.codex/config.toml.

~/.codex/config.toml
3

Run Codex

Перед запуском задайте ключ в переменной окружения.

terminal
Integration

Roo Code

Для Roo Code используйте OpenAI Compatible provider. Для thinking/reasoning моделей отдельный base URL указывает на /v1thinking/.

1

Open provider settings

В расширении Roo Code откройте API Provider settings.

2

Select OpenAI Compatible

Заполните поля как ниже.

Roo Code fields
3

Save and test

Сохраните provider и отправьте короткий тестовый запрос из Roo Code.

Integration

Gemini CLI

Используйте OpenRouter-compatible fork/client, который читает OPENROUTER_BASE_URL и OPENROUTER_API_KEY.

1

Install compatible client

Нужна версия, где OpenRouter base URL можно переопределить переменной окружения.

2

Set OpenRouter-compatible env

terminal
3

Run Gemini CLI

Запускайте клиент только после того, как переменные видны в текущем terminal.

FAQ

Коротко по архитектуре

Что важно понимать перед выдачей ключей клиентам.

Это заменяет старый bridge?
Нет. Старые инструкции и bridge endpoint остаются отдельно. Route endpoint нужен для новой линейки моделей через NewAPI.
Где создаются клиентские ключи?
Ключи создаются в CRM. Дальше CRM должна создавать или синхронизировать соответствующий token в NewAPI и назначать нужную группу моделей.
Какие upstream-ключи видит клиент?
Никакие. Клиент получает только наш CRM/Route key. NanoGPT, OpenRouter или другие upstream credentials остаются внутри NewAPI.
Почему здесь нет MCP и x402?
Этот MVP намеренно только OpenAI-compatible и Anthropic-compatible. MCP, x402, scraping и media endpoints можно оформить позже отдельными инструкциями, когда они будут нужны в продукте.