Меню документации
Справочник
Справочник APIСправочник API
v1· Обновлено: июль 2026 г.160+ моделей · 12 семейств моделей
WayJet — шлюз, совместимый с OpenAI. Направьте любой SDK OpenAI на базовый URL ниже, используйте API-ключ sk- и обращайтесь ко всем поставщикам через единый API.
12 семейств моделей
OpenAI, Anthropic, Gemini, Groq и другие — за одним API.
Совместим с OpenAI
Направьте любой SDK OpenAI на базовый URL — без изменений в коде.
Потоковая передача
Потоковый SSE по токенам в chat completions из коробки.
Ключи и бюджеты
Ключи с ограниченными правами, лимиты расходов по периодам и учёт использования.
Вызовите GET /v1/models со своим ключом, чтобы увидеть модели, доступные через шлюз.
Введение#
Все запросы идут на один базовый URL. Шлюз говорит на формате OpenAI, поэтому существующие SDK и инструменты работают без изменений — достаточно заменить базовый URL и ключ.
https://api.wayjet.ai/v1Аутентификация#
Аутентификация — токеном Bearer в заголовке Authorization. Создайте ключ с префиксом sk- на странице API-ключей: секрет показывается только один раз, сохраните его в надёжном месте.
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
Быстрый старт#
Отправьте свой первый chat completion. Запишите свой API-ключ в WAYJET_API_KEY и запустите пример как есть или замените gpt-5.1 на любой id модели из GET /v1/models — он перечисляет модели, доступные вашему ключу.
curl https://api.wayjet.ai/v1/chat/completions \
-H "Authorization: Bearer $WAYJET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.1",
"messages": [{"role": "user", "content": "Hello"}]
}'Chat completions#
POST /v1/chat/completions — основной эндпоинт. Запросы и ответы следуют схеме OpenAI; шлюз добавляет в ответ provider и cache_status.
| Параметр | Тип | Описание |
|---|---|---|
| model* | string | Id модели из GET /v1/models (в примерах — gpt-5.1) |
| messages* | array | Сообщения диалога (role + content) |
| stream | boolean | Возвращать токены как server-sent events |
| temperature | number | Температура выборки, 0–2 (по умолчанию 1) |
| max_tokens | integer | Максимум генерируемых токенов |
| top_p | number | Вероятностная масса nucleus-выборки |
| tools | array | Описания функций/инструментов, которые может вызвать модель |
| tool_choice | string | object | Принудительный или ограниченный выбор инструмента |
| response_format | object | например, { "type": "json_object" } для режима JSON |
| reasoning_effort | string | low · medium · high (модели с рассуждением) |
| stop | string | array | До 4 стоп-последовательностей |
| seed | integer | Детерминированная выборка, насколько это возможно |
| provider | string | Только для шлюза — закрепить запрос за одним поставщиком |
* обязательный
Потоковая передача#
Укажите stream: true, чтобы получать токены как server-sent events. Каждое событие — строка data: с дельтой; поток заканчивается строкой data: [DONE].
curl https://api.wayjet.ai/v1/chat/completions \
-H "Authorization: Bearer $WAYJET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.1",
"messages": [{"role": "user", "content": "Hello"}],
"stream": true
}'
# → server-sent events: lines of data: {...} terminated by data: [DONE]Кэширование промптов#
Некоторые поставщики кэшируют начало недавно увиденного промпта и берут меньше за его повторную обработку. В OpenAI, Gemini и DeepSeek это происходит автоматически: от вас не нужно никаких параметров, и ни вы, ни WayJet не можете это отключить. Anthropic кэширует только по запросу.
С ключом платформы WayJet учитывает `cache_control` только для аккаунтов, закреплённых за собственным рабочим пространством Anthropic. В остальных случаях маркер принимается и удаляется до того, как запрос попадёт в Anthropic. Вызов всё равно проходит, но в его usage нет токенов кэша, и каждый входной токен оплачивается по полной входной ставке — столько же за него берёт и Anthropic. С вашим собственным ключом Anthropic маркер проходит всегда.
Каждый поставщик проводит границу кэша по своему клиенту. При ключе платформы WayJet этот клиент — WayJet, поэтому у трёх поставщиков с автоматическим кэшем ваши запросы делят одно пространство кэша с другими аккаунтами WayJet в течение указанного ниже окна. Шлюз возвращает cache_status в chat completions, но он сообщает, был ли префикс использован повторно, а не чей он.
| Поставщик | Кэширование | Граница кэша | Окно повторного использования |
|---|---|---|---|
| OpenAI | Автоматически | Организация — при ключе платформы это организация WayJet | до 30 мин |
| Gemini | Автоматически | Проект Google Cloud — при ключе платформы это проект WayJet | до 24 ч |
| DeepSeek | Автоматически | Аккаунт — при ключе платформы это аккаунт WayJet | от часов до дней |
| Anthropic | По запросу (cache_control), с вашим ключом или закреплённым аккаунтом | Ваш собственный аккаунт (BYOK) или ваше закреплённое рабочее пространство | 5 мин |
| Claude в Bedrock / Vertex | По запросу, только со своими учётными данными | Аккаунт AWS / проект GCP | 5 мин |
Что означает общий кэш, а что — нет
Через кэш промптов не проходит никакое содержимое промптов или ответов. Попадание в кэш — это поставщик, который дешевле повторно обрабатывает префикс, уже отправленный самим вызывающим: он никому не передаёт чужой текст. Общее пространство раскрывает лишь время: тот, у кого уже есть точный префикс, теоретически мог бы по более быстрому или дешёвому ответу понять, что этот префикс недавно отправлялся. Для этого нужно сначала знать префикс — это и ограничивает риск.
Мы публикуем это, потому что вы не можете увидеть это сами. WayJet намеренно скрывает, какой поставщик обработал запрос, поэтому ни API, ни панель не скажут, где проходит граница кэша поставщика. Если вы перепродаёте инференс своим пользователям, это ответ на тот же вопрос уровнем ниже.
Если вам нужно собственное пространство кэша
Есть два пути, и только они честные: на ключе платформы нет настройки для отдельного клиента, которая бы это обеспечила.
- Используйте свой ключ. Добавьте собственные учётные данные поставщика — тогда ваш трафик идёт от вашего аккаунта у поставщика, и граница кэша проходит по вам. Это работает у всех поставщиков и полностью решает задачу.
- Запросите рабочее пространство Anthropic. Только для Anthropic мы можем закрепить ваш аккаунт за собственным рабочим пространством Anthropic, и ваш кэш промптов станет только вашим, а вы продолжите пользоваться ключом платформы. Это делается по запросу и для каждого аккаунта отдельно — переключателя самообслуживания нет, и это не действует для Claude через Bedrock или Vertex, где аналога нет. Это же единственный способ включить кэширование Anthropic для аккаунта на ключе платформы.
Эмбеддинги#
POST /v1/embeddings — векторизация текста для поиска и RAG. Принимает строку или массив строк.
curl https://api.wayjet.ai/v1/embeddings \
-H "Authorization: Bearer $WAYJET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "your-embedding-model",
"input": "The quick brown fox"
}'Аудио (речь)#
POST /v1/audio/speech превращает текст в речь (оплата за символ на входе), а POST /v1/audio/transcriptions превращает загруженный аудиофайл в текст (оплата за минуту аудио). Оба совместимы с OpenAI.
Синтез речи
curl https://api.wayjet.ai/v1/audio/speech \
-H "Authorization: Bearer $WAYJET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "your-tts-model",
"input": "The quick brown fox jumped over the lazy dog.",
"voice": "alloy"
}' \
--output speech.mp3Распознавание речи
Загрузите файл как multipart/form-data. Укажите в response_format значение srt, vtt или verbose_json, чтобы получить субтитры с таймкодами вместо простого текста.
curl https://api.wayjet.ai/v1/audio/transcriptions \ -H "Authorization: Bearer $WAYJET_API_KEY" \ -F "model=your-stt-model" \ -F "file=@audio.mp3" \ -F "response_format=json" # json (default) · text · srt · vtt · verbose_json
Модели#
GET /v1/models возвращает каталог, доступный вашему ключу, с ценами и возможностями каждой модели. Используйте id из этого списка как model во всех примерах на этой странице.
curl https://api.wayjet.ai/v1/models \ -H "Authorization: Bearer $WAYJET_API_KEY"
Инструменты CLI (Claude Code, Codex)#
Шлюз поддерживает Messages API от Anthropic (POST /v1/messages) и Responses API от OpenAI (POST /v1/responses), поэтому популярные CLI для программирования подключаются к WayJet напрямую и оплачиваются по вашему ключу — без прокси и без SDK каждого поставщика. Направьте каждый инструмент на модель, которую вы можете вызвать.
Что такое squad?
Squad — это имя модели, которое вы вызываете: именованный продукт шлюза, который отвечает под своим именем. Используйте имя squad везде, где указывается имя модели. GET /v1/models перечисляет те, что доступны вашему ключу. Имена моделей в конфигурациях ниже — это squads, они работают как есть.
Claude Code
Добавьте в ~/.claude/settings.json. Ключ передаётся в ANTHROPIC_AUTH_TOKEN (или в ANTHROPIC_API_KEY как заголовок x-api-key), а каждый уровень соответствует выбранной вами модели.
{
"hasCompletedOnboarding": true,
"env": {
"ANTHROPIC_BASE_URL": "https://api.wayjet.ai",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
}
}Codex
Codex по умолчанию использует Responses API от OpenAI — переопределять wire_api = "chat" не нужно.
model = "gpt-5.1" model_provider = "wayjet" [model_providers.wayjet] name = "WayJet" base_url = "https://api.wayjet.ai/v1" wire_api = "responses"
{
"auth_mode": "apikey",
"OPENAI_API_KEY": "sk-your-key"
}Claude Code и Codex отправляют каждый запрос той единственной модели, которую называют.
Ошибки#
Ошибки используют стандартные коды состояния HTTP и структуру в стиле OpenAI.
{
"error": {
"message": "Incorrect API key provided.",
"type": "authentication_error",
"code": null,
"param": null
}
}| Код | Тип | Значение |
|---|---|---|
| 200 | OK | Запрос выполнен |
| 400 | invalid_request_error | Неверный запрос или недопустимые параметры |
| 401 | authentication_error | API-ключ отсутствует, недействителен или отозван |
| 403 | permission_error | Ключу не разрешено это действие |
| 404 | not_found_error | Неизвестная модель или ресурс |
| 429 | rate_limit_error | Превышен лимит запросов или бюджет |
| 500 | api_error | Непредвиденная ошибка шлюза |
Эндпоинты#
Эндпоинты, которые можно вызывать с API-ключом. Ключами, использованием и бюджетами управляют в панели.
| Метод | Эндпоинт | Описание |
|---|---|---|
| POST | /v1/chat/completions | Chat completion (потоковый и обычный) |
| POST | /v1/messages | Формат Messages от Anthropic (потоковый и обычный; x-api-key или Bearer) |
| POST | /v1/responses | Формат Responses от OpenAI (потоковый и обычный). Без состояния: previous_response_id игнорируется, поэтому каждый раз отправляйте весь диалог |
| GET | /v1/generation | Стоимость и токены одного запроса по его X-Wayjet-Request-Id (?id=) |
| POST | /v1/embeddings | Создать эмбеддинги |
| POST | /v1/audio/speech | Синтез речи (на выходе аудио) |
| POST | /v1/audio/transcriptions | Распознавание речи (транскрипция) |
| GET | /v1/models | Список доступных моделей |
Журнал изменений#
Заметные изменения публичного API. Базовый URL остаётся /v1 для обратной совместимости.
- июль 2026 г.Инструменты CLI: Claude Code (/v1/messages) и Codex (/v1/responses) напрямую. Статистика генерации (/v1/generation).
- июль 2026 г.Аудио: синтез речи (/v1/audio/speech) и распознавание (/v1/audio/transcriptions, в форматах srt/vtt/verbose_json).
- июнь 2026 г.Добавлен reasoning_effort.
- май 2026 г.Эндпоинт эмбеддингов и режим JSON (response_format).
- апр. 2026 г.Потоковая передача (SSE) в chat completions; закрепление поставщика.

