Подключение приложений и AI-агентов

Используйте один API-ключ Route Key и совместимый шлюз для приложений, SDK и инструментов разработки.

Шаг 01

Подключите AI-приложение

Трёх значений достаточно для первого совместимого запроса.

Base URLhttps://api.routekey.ai/v1
AuthorizationBearer YOUR_ROUTEKEY_API_KEY
МодельВыберите включённый ID в Models.

Первый рабочий запрос

curl https://api.routekey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_ROUTEKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<route-key-model>","messages":[{"role":"user","content":"Hello"}]}'

Шаг 02

Настройте coding agent

Используйте отдельный ключ для каждого инструмента и скопируйте профиль настройки.

Install CodexОфициальная документация

npm install -g @openai/codex

~/.codex/config.toml

model = "<route-key-coding-model>"
model_provider = "routekey"

[model_providers.routekey]
name = "Route Key"
base_url = "https://api.routekey.ai/v1"
env_key = "ROUTEKEY_API_KEY"

Создайте отдельный API-ключ Route Key.
Выберите включённую модель в Models.
Перезапустите инструмент и проверьте Usage Logs.

Install Claude CodeОфициальная документация

npm install -g @anthropic-ai/claude-code

Environment variables

export ANTHROPIC_BASE_URL="https://api.routekey.ai"
export ANTHROPIC_AUTH_TOKEN="YOUR_ROUTEKEY_API_KEY"
export ANTHROPIC_MODEL="<route-key-model>"

Создайте отдельный API-ключ Route Key.
Выберите включённую модель в Models.
Перезапустите инструмент и проверьте Usage Logs.

Install Gemini CLIОфициальная документация

npm install -g @google/gemini-cli

Environment variables

export GEMINI_API_KEY="YOUR_ROUTEKEY_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://api.routekey.ai"
export GEMINI_MODEL="<route-key-model>"

Создайте отдельный API-ключ Route Key.
Выберите включённую модель в Models.
Перезапустите инструмент и проверьте Usage Logs.

Install CursorОфициальная загрузка

Open Cursor Settings and add a provider profile.

Provider profile

Provider: OpenAI-compatible
Base URL: https://api.routekey.ai/v1
API key: YOUR_ROUTEKEY_API_KEY
Model: <route-key-model>

Создайте отдельный API-ключ Route Key.
Выберите включённую модель в Models.
Перезапустите инструмент и проверьте Usage Logs.

Операционный список

Сохраняйте интеграции обслуживаемыми

OpenAI-совместимость упрощает миграцию, но нужны отдельные ключи, проверенная модель, настраиваемый base URL и наблюдаемость. Модели.

Открыть документацию Сравнить модели

Подготовьте безопасное и воспроизводимое подключение API

Создайте и защитите API-ключ

Создайте ключ в Dashboard и используйте отдельный ключ для каждого приложения или инструмента. Храните его в секретах, не в коде и не в логах.

Три значения запроса

Base URL выбирает шлюз, Bearer-токен выполняет аутентификацию, а ID модели выбирает включённую модель. Используйте точный ID из Models. Модели.

Проверьте доступ до запуска

Проверьте баланс или квоту, группу модели и поддержку endpoint. Короткий запрос без streaming быстрее всего выявляет причину ошибки.

Проверьте ответ и Usage Logs

Отправьте короткий запрос и проверьте обычный ответ или поток.
Запишите ID модели и endpoint, которые вернули ответ.
Проверьте в Usage Logs запрос, токены, задержку и стоимость.
Добавляйте streaming, инструменты, длинный контекст и параллельность по одному.

Ошибки аутентификации 401 или 403

Проверьте префикс Authorization: Bearer, пробелы, состояние ключа и base URL /v1.

Модель не найдена или недоступна

Скопируйте включённый ID из Models и проверьте группу и endpoint.

Ошибки квоты, баланса или скорости

Проверьте кошелёк, ограничения и Usage Logs. Уменьшите параллельность или длину ответа.

Можно ли использовать существующий OpenAI SDK?

Обычно да. Сохраните формат SDK, укажите base URL Route Key /v1 и передайте API-ключ Route Key.

Нужно ли делиться одним ключом между инструментами?

Нет. Отдельный ключ для приложения или агента упрощает логи и ротацию.

Где искать разницу в стоимости?

Сравните в Usage Logs модель, коэффициент группы, токены, endpoint и время, затем проверьте каталог цен.