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

RouteAPI предоставляет единую точку авторизации для OpenAI-совместимого API, Claude Messages и Google Gemini. Пройдите путь от регистрации до проверенного запроса и выберите способ интеграции для своего приложения.

Что подготовить

Нужны аккаунт RouteAPI, токен из консоли и ID модели, доступной этому токену. Храните токен на сервере или в переменной окружения, не публикуйте его в браузере и репозитории.

Три шага

1. Зарегистрируйтесь. Откройте консоль RouteAPI и зарегистрируйтесь по email или через Google. На панели видны баланс, использование и состояние аккаунта.
2. Создайте токен. Откройте Token Management → Create Key, задайте имя и срок действия, при необходимости добавьте квоту и ограничения моделей.
3. Отправьте тест. Запишите токен в ROUTEAPI_KEY, выберите доступную модель и выполните пример cURL.

Указывайте ID модели

Доступность зависит от токена. Используйте значение id из списка моделей, а не отображаемое имя.

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

export ROUTEAPI_KEY="sk-your-routeapi-token"
curl https://api.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"Привет, RouteAPI"}]}'

Ответ содержит сообщение и сведения об использовании. Если API или клиент возвращает ID запроса, сохраните его для диагностики. Если gpt-5.5 недоступна, замените её на ID из GET /v1/models.

Выберите способ интеграции

Прямой API cURL или любой HTTP-клиент без дополнительных зависимостей.

OpenAI SDK Сохраните существующий код и замените ключ и Base URL.

Инструменты разработчика Настройте Codex, Cursor, Claude Code, OpenCode, LangChain или LiteLLM.

Node.js и Python

Выберите среду выполнения, установите соответствующий официальный OpenAI SDK и укажите Base URL RouteAPI:

bun add openai
pip install openai

import OpenAI from 'openai';
const client = new OpenAI({ apiKey: process.env.ROUTEAPI_KEY, baseURL: 'https://api.routeapi.ai/v1' });
const response = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: 'Представьте RouteAPI одним предложением' }],
});
console.log(response.choices[0].message.content);

Полные примеры: Node.js, Python, OpenAI SDK.

Потоковый вывод

Добавьте stream: true, чтобы получать SSE по мере генерации. Читайте data: и завершайте ответ после data: [DONE]. Подробности — в разделе Потоковые ответы.

curl https://api.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","stream":true,"messages":[{"role":"user","content":"Объясните RouteAPI в трёх пунктах"}]}'

Проверка и ошибки

curl https://api.routeapi.ai/v1/models -H "Authorization: Bearer $ROUTEAPI_KEY"

• 401 — проверьте токен и заголовок Authorization.
• 402 — проверьте баланс и квоту токена.
• 429 — уменьшите частоту запросов.
• 502/503 — проверьте сервис модели и ограничьте повторы.
• Модель недоступна — проверьте точный ID и поддерживаемые возможности.

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

Следующие шаги

Обзор API Протоколы, Base URL, заголовки и ограничения.

Модели и цены ID, возможности, доступность и текущие тарифы.

Маршрутизация и fallback Пути сервиса и защита от сбоев перед запуском в production.

В production храните токены на сервере, фиксируйте ID моделей, записывайте ID запросов и проверяйте дополнительные возможности на выбранной модели.