Меню документации

Начало работы

ОбзорБыстрый старт

Справочник

Справочник 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-ключей: секрет показывается только один раз, сохраните его в надёжном месте.

header
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
Никогда не раскрывайте ключ в клиентском коде. Вызывайте шлюз со своего сервера или через прокси.
Создать API-ключ

Быстрый старт#

Отправьте свой первый 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*stringId модели из GET /v1/models (в примерах — gpt-5.1)
messages*arrayСообщения диалога (role + content)
streambooleanВозвращать токены как server-sent events
temperaturenumberТемпература выборки, 0–2 (по умолчанию 1)
max_tokensintegerМаксимум генерируемых токенов
top_pnumberВероятностная масса nucleus-выборки
toolsarrayОписания функций/инструментов, которые может вызвать модель
tool_choicestring | objectПринудительный или ограниченный выбор инструмента
response_formatobjectнапример, { "type": "json_object" } для режима JSON
reasoning_effortstringlow · medium · high (модели с рассуждением)
stopstring | arrayДо 4 стоп-последовательностей
seedintegerДетерминированная выборка, насколько это возможно
providerstringТолько для шлюза — закрепить запрос за одним поставщиком

* обязательный

Потоковая передача#

Укажите 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 / проект GCP5 мин

Что означает общий кэш, а что — нет

Через кэш промптов не проходит никакое содержимое промптов или ответов. Попадание в кэш — это поставщик, который дешевле повторно обрабатывает префикс, уже отправленный самим вызывающим: он никому не передаёт чужой текст. Общее пространство раскрывает лишь время: тот, у кого уже есть точный префикс, теоретически мог бы по более быстрому или дешёвому ответу понять, что этот префикс недавно отправлялся. Для этого нужно сначала знать префикс — это и ограничивает риск.

Мы публикуем это, потому что вы не можете увидеть это сами. 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 во всех примерах на этой странице.

shell
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), а каждый уровень соответствует выбранной вами модели.

~/.claude/settings.json
{
  "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" не нужно.

~/.codex/config.toml
model = "gpt-5.1"
model_provider = "wayjet"

[model_providers.wayjet]
name = "WayJet"
base_url = "https://api.wayjet.ai/v1"
wire_api = "responses"
~/.codex/auth.json
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-your-key"
}

Claude Code и Codex отправляют каждый запрос той единственной модели, которую называют.

Ошибки#

Ошибки используют стандартные коды состояния HTTP и структуру в стиле OpenAI.

json
{
  "error": {
    "message": "Incorrect API key provided.",
    "type": "authentication_error",
    "code": null,
    "param": null
  }
}
КодТипЗначение
200OKЗапрос выполнен
400invalid_request_errorНеверный запрос или недопустимые параметры
401authentication_errorAPI-ключ отсутствует, недействителен или отозван
403permission_errorКлючу не разрешено это действие
404not_found_errorНеизвестная модель или ресурс
429rate_limit_errorПревышен лимит запросов или бюджет
500api_errorНепредвиденная ошибка шлюза
Посмотреть использование и лимиты

Эндпоинты#

Эндпоинты, которые можно вызывать с API-ключом. Ключами, использованием и бюджетами управляют в панели.

МетодЭндпоинтОписание
POST/v1/chat/completionsChat 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; закрепление поставщика.
Полный журнал изменений