Документация GoRouter

Задача

GoRouter предоставляет единый OpenAI-совместимый API по адресу https://gorouter.ru/api/v1. Для inference-запросов нужен inference key из кабинета.

Перед интеграцией можно выбрать модель в каталоге, открыть содержательные подборки по задачам и проверить текущие цены в рублях.

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

Рабочий пример

curl https://gorouter.ru/api/v1/chat/completions \
  -H "Authorization: Bearer $GOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash-0731",
    "messages": [{"role": "user", "content": "Привет!"}],
    "max_tokens": 1024
  }'

Важные параметры

• model — идентификатор из каталога /api/v1/models.
• Authorization — заголовок Bearer с inference key.
• X-GoRouter-Title — необязательное название приложения для журнала запросов. Для совместимости также принимаются X-OpenRouter-Title и X-Title; если передано несколько заголовков, используется X-GoRouter-Title.
• max_tokens — предел ответа, включая reasoning. В пробном запросе ограничивает размер резерва; запросы из документации оплачиваются с вашего баланса.
• provider — необязательные настройки выбора провайдера; по умолчанию маршрут выбирается автоматически с учётом цены и доступности.

Ответ

Ответ повторяет формат выбранного совместимого endpoint. Если upstream возвращает usage, GoRouter записывает итоговую стоимость в usage.cost и указывает её в RUB.

Ошибки и ограничения

• Management key не подходит для inference и получает 403 management_key_not_allowed.
• Любая задолженность аккаунта блокирует новые платные и бесплатные генерации через API, веб-чат и playground: 402 outstanding_debt. Пополнение сначала погашает долг. Уже отправленные провайдеру запросы продолжаются по прежним правилам; ожидающие в очереди отменяются, если долг появился до отправки.
• Для нового платного запроса также нужны положительный доступный баланс и неисчерпанный расходный лимит ключа. При отсутствии долга бесплатные модели GoRouter доступны с нулевым балансом и не расходуют денежные лимиты.
• Поддержка параметров зависит от выбранной модели и провайдера.