Gateway
Общая информация

Введение

Что такое Gateway и как он устроен для клиента

Gateway — платформа для команд, которые используют модели ИИ в своих продуктах и хотят управлять доступом, оплатой, ключами и статистикой в одном месте.

Клиент работает с двумя поверхностями:

  • Дашборд — для настроек, оплаты, ключей и аналитики.
  • Публичный API /v1 — для запросов из вашего приложения.

Внутренняя инфраструктура Gateway скрыта. В клиентский код не попадают служебные адреса, внутренние ключи, поставщики и техническая маршрутизация.

Что решает платформа

Gateway помогает не собирать вокруг моделей отдельную самодельную обвязку:

  • ключи API создаются и отзываются в Дашборде;
  • разные проекты разделяются по рабочим пространствам;
  • команда видит расход, ошибки и историю запросов;
  • тариф управляет лимитами и доступными функциями;
  • запросы к моделям идут через OpenAI-совместимые маршруты;
  • Tools API помогает получать поисковый и веб-контекст для приложений.

Основные сущности

Организация объединяет команду, оплату и общие лимиты.

Рабочее пространство отделяет один проект, окружение или клиента от другого.

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

Логи и использование показывают, что происходит с запросами: какие модели вызываются, сколько токенов тратится, где возникают ошибки.

Быстрый путь

  1. Зарегистрируйтесь в Дашборде.
  2. Выберите тариф.
  3. Создайте рабочее пространство.
  4. Выпустите ключ API.
  5. Отправьте запрос на /v1/chat/completions.
  6. При необходимости вызовите /v1/tools/*, чтобы найти или извлечь внешний контекст.
  7. Проверьте логи и расход в Дашборде.
curl {{PUBLIC_API_BASE_URL}}/chat/completions \
  -H "Authorization: Bearer gw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "provider/model-name",
    "messages": [
      {"role": "user", "content": "Коротко объясни, что ты умеешь."}
    ]
  }'

Что читать дальше

  • «Быстрый старт» — первый ключ и первый запрос.
  • «Tools API» — поиск, извлечение страниц и исследовательские задачи.
  • «Дашборд» — как управлять рабочими пространствами, ключами, логами и оплатой.
  • «Enterprise» — возможности для компаний с индивидуальными требованиями.
  • «Справочник API» — поддерживаемые маршруты /v1.