Gateway Docs

Этот путь подходит для первого подключения. В боевом проекте храните ключи только на сервере или в менеджере секретов.

1. Зарегистрируйтесь

Откройте Дашборд и создайте учётную запись. После первого входа Gateway создаёт личную организацию и первое рабочее пространство.

Если Дашборд просит подтвердить почту, сделайте это до настройки боевого доступа. Так проще восстановить аккаунт и получать важные уведомления.

Для запросов к моделям нужна активная подписка. Для старта обычно достаточно Plus; для подробных логов, Tools API и экспорта статистики нужен Pro. Управление командой и ролями доступно на Enterprise.

Для Tools API нужен Pro или индивидуальный Enterprise-доступ.

Enterprise подключается отдельно, если нужны свои ключи поставщиков, повышенные лимиты или договорные условия.

3. Создайте рабочее пространство

Рабочее пространство — граница проекта. Не смешивайте боевой продукт, тестовый стенд и эксперименты в одном пространстве.

Хорошая схема:

production — боевой продукт;
staging — тестовый стенд;
internal-tools — внутренние инструменты;
отдельное пространство на крупного клиента, если нужна раздельная статистика.

4. Выпустите ключ

Перейдите в «Ключи API» и создайте ключ. Сырой ключ показывается только один раз.

export SLOPDEALER_API_KEY="gw_live_..."

Сразу задайте понятное имя: например, Production backend, Staging jobs, Support bot. Через месяц это сильно упростит поиск в логах.

5. Отправьте первый запрос

curl {{PUBLIC_API_BASE_URL}}/chat/completions \
  -H "Authorization: Bearer $SLOPDEALER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "provider/model-name",
    "messages": [
      {"role": "system", "content": "Отвечай кратко и понятно."},
      {"role": "user", "content": "Составь три идеи для онбординга."}
    ]
  }'

Если вы уже используете OpenAI-клиент, обычно нужно поменять только baseURL, ключ и имя модели.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.SLOPDEALER_API_KEY,
  baseURL: "{{PUBLIC_API_BASE_URL}}",
});

const result = await client.chat.completions.create({
  model: "provider/model-name",
  messages: [{ role: "user", content: "Ответь одним предложением." }],
});

console.log(result.choices[0]?.message?.content);

6. Попробуйте Tools API

Если приложению нужен свежий поисковый контекст, вызовите инструмент тем же ключом API.

curl "{{PUBLIC_API_BASE_URL}}/tools/serpapi/search?q=latest%20AI%20news&engine=google_light" \
  -H "Authorization: Bearer $SLOPDEALER_API_KEY"

Результаты поиска можно обработать на сервере и передать модели как контекст в следующем запросе.

7. Проверьте Дашборд

После запроса откройте:

«Логи» — статус, модель или tool operation, ключ и длительность;
«Использование» — графики расхода по моделям и Tools API;
страницу ключа — модельные запросы и tool requests, связанные с этим ключом.

Статистика может появиться не мгновенно: часть данных подтягивается фоново.

Если что-то пошло не так

401 — ключ не передан, введён неверно или отозван.

403 — нет активного доступа, ключ выключен, модель запрещена или сработал лимит.

429 — слишком много запросов или токенов за короткое время.

5xx — временная ошибка платформы или модели. Повторите запрос с задержкой.

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