Waibee Router
Waibee Router это единый шлюз к LLM-провайдерам: единый API поверх разных моделей и провайдеров. Он принимает запросы в форматах **OpenAI Chat Completions** (`POST /v1/chat/completions`), **Anthropic Messages** (`POST /v1/messages`) и **OpenAI Responses** (`POST /v1/responses`), поэтому клиент, уже умеющий работать с этими API, переключается на Waibee сменой base URL и API-ключа.
## Три формата запросов
Все три ходят к одним и тем же моделям из [каталога](/router/models/), списывают
деньги одинаково и умеют одно и то же: инструменты, стриминг, вложения, веб-поиск,
DLP. Различается язык, на котором говорит ваш клиент.
| Формат | Путь | Кому он |
|---|---|---|
| OpenAI Chat Completions | `/v1/chat/completions` | Значение по умолчанию: его понимает почти любой клиент и любая библиотека |
| Anthropic Messages | `/v1/messages` | Клиентам на Anthropic SDK, включая Claude Code |
| [OpenAI Responses](/router/responses-api/) | `/v1/responses` | Клиентам на новом формате OpenAI: Codex CLI, Agents SDK, `client.responses.create()` |
Chat Completions и Responses оба формата OpenAI, и оба доступны через один и тот же
официальный SDK: `client.chat.completions.create()` и `client.responses.create()`.
Responses устроен вокруг элементов вместо сообщений, поэтому рассуждения, вызовы
инструментов и текст приходят отдельными элементами с собственным статусом.
Если ваш клиент понимает Chat Completions и вам всё равно, берите его: он самый
распространённый. Responses берите, если ваш инструмент говорит на нём или вам
нужны элементы.
## С чего начать
- [Быстрый старт](/router/quickstart/): первый запрос за пять минут.
- [Аутентификация](/router/authentication/): API-ключи и Bearer-токены.
- [Формат Responses](/router/responses-api/): элементы, многоходовость и чего роутер на нём не делает.
## Интеграции
Подключение Waibee как провайдера в готовых инструментах:
- [OpenAI-совместимые клиенты](/router/integrations/openai-compatible/): SDK, Cline, Continue и другие.
- [Anthropic-совместимые клиенты](/router/integrations/anthropic-compatible/): SDK на Messages API.
- [Claude Code](/router/integrations/claude-code/): через Anthropic Messages API.
- [Codex CLI](/router/integrations/codex/): через Responses API.
- [OpenCode](/router/integrations/opencode/): как OpenAI-совместимый провайдер.
- [pi](/router/integrations/pi/): свой провайдер в `models.json`, без плагинов.
- [Hermes Agent](/router/integrations/hermes/): свой провайдер в `config.yaml`, без плагинов.
## Возможности
- [Веб-поиск](/router/web-search/): модель ищет в интернете сама, а поиск за неё выполняет роутер. Работает на всех трёх форматах.
- [Autorouting](/router/autorouting/): роутер сам подбирает модель под запрос.
- [Вызов инструментов](/router/tool-calling/): функции, цикл вызова, стриминг.
- [Structured outputs](/router/structured-outputs/): ответ строго по JSON Schema.
- [Reasoning](/router/reasoning/): уровни рассуждений и их цена.
- [Изображения и PDF](/router/attachments/): вложения в запросе.
- [Кэширование промптов](/router/prompt-caching/): повторное использование стабильного префикса.
## Практика
- [Рецепты](/router/cookbook/): готовый код под типовые задачи, от вызова инструментов до таймаутов и повторов в сервисе.
- [Переход на Waibee](/router/migration/): что менять в коде при переходе с OpenAI, Anthropic или другого шлюза.
## Справочник
- [Модели](/router/models/): идентификаторы, каталог, цены.
- [Токены и usage](/router/usage/): счётчики и оценка стоимости.
- [Лимиты](/router/limits/): размеры запроса, частота, повторные попытки.
- [API Reference](/router/api/): полный справочник эндпоинтов, параметров и ошибок.
- [Глоссарий](/glossary/): термины, которые встречаются в документации.
Waibee Router это единый шлюз к LLM-провайдерам: единый API поверх разных моделей и провайдеров. Он принимает запросы в форматах OpenAI Chat Completions (POST /v1/chat/completions), Anthropic Messages (POST /v1/messages) и OpenAI Responses (POST /v1/responses), поэтому клиент, уже умеющий работать с этими API, переключается на Waibee сменой base URL и API-ключа.
Три формата запросов
Заголовок раздела «Три формата запросов»Все три ходят к одним и тем же моделям из каталога, списывают деньги одинаково и умеют одно и то же: инструменты, стриминг, вложения, веб-поиск, DLP. Различается язык, на котором говорит ваш клиент.
| Формат | Путь | Кому он |
|---|---|---|
| OpenAI Chat Completions | /v1/chat/completions |
Значение по умолчанию: его понимает почти любой клиент и любая библиотека |
| Anthropic Messages | /v1/messages |
Клиентам на Anthropic SDK, включая Claude Code |
| OpenAI Responses | /v1/responses |
Клиентам на новом формате OpenAI: Codex CLI, Agents SDK, client.responses.create() |
Chat Completions и Responses оба формата OpenAI, и оба доступны через один и тот же
официальный SDK: client.chat.completions.create() и client.responses.create().
Responses устроен вокруг элементов вместо сообщений, поэтому рассуждения, вызовы
инструментов и текст приходят отдельными элементами с собственным статусом.
Если ваш клиент понимает Chat Completions и вам всё равно, берите его: он самый распространённый. Responses берите, если ваш инструмент говорит на нём или вам нужны элементы.
С чего начать
Заголовок раздела «С чего начать»- Быстрый старт: первый запрос за пять минут.
- Аутентификация: API-ключи и Bearer-токены.
- Формат Responses: элементы, многоходовость и чего роутер на нём не делает.
Интеграции
Заголовок раздела «Интеграции»Подключение Waibee как провайдера в готовых инструментах:
- OpenAI-совместимые клиенты: SDK, Cline, Continue и другие.
- Anthropic-совместимые клиенты: SDK на Messages API.
- Claude Code: через Anthropic Messages API.
- Codex CLI: через Responses API.
- OpenCode: как OpenAI-совместимый провайдер.
- pi: свой провайдер в
models.json, без плагинов. - Hermes Agent: свой провайдер в
config.yaml, без плагинов.
Возможности
Заголовок раздела «Возможности»- Веб-поиск: модель ищет в интернете сама, а поиск за неё выполняет роутер. Работает на всех трёх форматах.
- Autorouting: роутер сам подбирает модель под запрос.
- Вызов инструментов: функции, цикл вызова, стриминг.
- Structured outputs: ответ строго по JSON Schema.
- Reasoning: уровни рассуждений и их цена.
- Изображения и PDF: вложения в запросе.
- Кэширование промптов: повторное использование стабильного префикса.
Практика
Заголовок раздела «Практика»- Рецепты: готовый код под типовые задачи, от вызова инструментов до таймаутов и повторов в сервисе.
- Переход на Waibee: что менять в коде при переходе с OpenAI, Anthropic или другого шлюза.
Справочник
Заголовок раздела «Справочник»- Модели: идентификаторы, каталог, цены.
- Токены и usage: счётчики и оценка стоимости.
- Лимиты: размеры запроса, частота, повторные попытки.
- API Reference: полный справочник эндпоинтов, параметров и ошибок.
- Глоссарий: термины, которые встречаются в документации.