Документация 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.
• max_tokens — предел ответа, включая reasoning. В пробном запросе ограничивает размер резерва; запросы из документации оплачиваются с вашего баланса.
• provider — необязательные настройки выбора провайдера; по умолчанию используется сортировка по цене.

Ответ

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

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

• Management key не подходит для inference и получает 403 management_key_not_allowed.
• Запрос не выполняется при нулевом балансе или исчерпанном лимите ключа.
• Поддержка параметров зависит от выбранной модели и провайдера.