RouterAI Ru
Войти Начать

API RouterAI — ключ, адрес и совместимость

RouterAI работает по формату OpenAI API: тот же код, другой base URL и ключ. Один эндпоинт открывает 400+ моделей, стриминг, tools и structured outputs, оплата — в рублях.

Начать в RouterAI
curl https://routerai.ru/api/v1/chat/completions \  -H "Authorization: Bearer $ROUTERAI_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "openai/gpt-6.1-sol",    "stream": true,    "messages": [{"role": "user", "content": "..."}]  }'
Адрес APIhttps://routerai.ru/api/v1

Как получить API-ключ

  1. Зарегистрируйтесь на RouterAI
  2. Откройте «Настройки», затем «API-ключи»
  3. Нажмите «Создать новый ключ»
  4. Скопируйте и сохраните ключ

Эндпоинты RouterAI

  • POST/v1/chat/completionsОтветы моделей в формате OpenAI
  • POST/v1/responsesФормат Responses
  • POST/v1/messagesФормат Anthropic, для Claude Code
  • POST/v1/embeddingsВекторы текста
  • POST/v1/imagesГенерация картинок
  • POST/v1/videosГенерация видео
  • POST/v1/audio/speechСинтез и распознавание речи
  • GET/v1/modelsСписок моделей и цен
  • GET/v1/creditsОстаток баланса

Типы ключей

API-ключ

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

Мастер-ключ

Создаёт, показывает и удаляет ключи через /keys, выпускается только в интерфейсе

Работает ли RouterAI с кодом под OpenAI

RouterAI совместим с форматом OpenAI API. Адрес — https://routerai.ru/api/v1, запросы идут к https://routerai.ru/api/v1/chat/completions. Готовый код на OpenAI SDK и других популярных библиотеках работает без переписывания: замените base URL и ключ, остальное не трогайте.

Стриминг, вызов функций (tools) и structured outputs поддерживаются так же, как в OpenAI. Кроме Chat Completions и Responses доступны эндпоинты для embeddings, генерации картинок и видео, аудио, файлов и работы с ключами и командой.

Есть отдельный Anthropic-совместимый эндпоинт /api/v1/messages, через него к RouterAI подключаются инструменты вроде Claude Code.

Как управлять лимитами и защищать ключ

У каждого API-ключа свой месячный лимит расходов: он назначается ключу, раз в месяц сбрасывается, у лимита есть остаток. Ключ и адрес API при этом не меняются: модель меняется заменой идентификатора в поле model.

Выдавайте отдельный ключ под каждый проект или среду и ставьте каждому потолок. Мастер-ключ, через который создаются и удаляются обычные ключи, в код приложения не кладут, потому что он создаётся и используется только в интерфейсе.

Чтобы начать работу, зарегистрируйтесь, пополните баланс картой или по безналичному расчёту и отправьте первый запрос.

Резервный провайдер и режимы скорости

Если у провайдера модель недоступна, запрос автоматически уходит к резервному провайдеру. Переключение происходит внутри RouterAI, менять в коде ничего не нужно.

Скорость обработки управляется параметром service_tier. Режим flex обычно на 50 % дешевле стандартной цены, priority стоит дороже. Параметр действует во всех трёх форматах запросов: Chat Completions, Responses и Messages.

Для фоновых задач, где ответ можно подождать, ставьте flex. Priority выбирайте там, где важна скорость ответа пользователю.

Вопросы про API RouterAI

Ключ попал в чужие руки. Что делать?

Перевыпустите ключ в настройках: старый токен перестанет работать сразу, а название, лимиты и статистика сохранятся.

Где посмотреть base URL для SDK?

Base URL показан в настройках рядом со списком ключей, там же создаётся новый ключ.

Тот же ключ подходит для эмбеддингов и картинок?

Да. Эндпоинты embeddings, images, videos и audio доступны по тому же адресу и с тем же ключом, что и Chat Completions.