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

Первый запрос chat completion через шлюз менее чем за пять минут.

Основы

Кратчайший путь от полученного ключа до рабочего chat completion. Если вы знакомы с curl, потребуется около пяти минут.

Что потребуется

Базовый URL шлюза — адрес вашего шлюза; для локальной разработки это <GatewayUrl/>.
API key с префиксом gw_ — создайте его в разделе API-ключей. Храните его как секрет: не коммитьте и не вставляйте в чат.
Слаг модели — выберите его на странице моделей. gpt-5.5 подходит как безопасное значение по умолчанию.

Стоимость

Каждый запрос списывает AI-кредиты из баланса аккаунта. Перед объёмной нагрузкой изучите все три ограничения в разделе «Лимиты и квоты».

Отправка запроса

Шлюз принимает стандартный формат chat/completions на /v1. Используйте существующий клиент, заменив только baseURL и ключ.

cURL

bash

curl -X POST https://api.toygate.store/v1/chat/completions \-H 'Authorization: Bearer gw_<your-key>' \-H 'Content-Type: application/json' \-d '{ "model": "gpt-5.5", "messages": [{ "role": "user", "content": "Say hi" }] }'

TypeScript

import OpenAI from "openai";const client = new OpenAI({apiKey: process.env.GATEWAY_KEY,baseURL: "https://api.toygate.store/v1",});const resp = await client.chat.completions.create({model: "gpt-5.5",messages: [{ role: "user", content: "Say hi" }],});console.log(resp.choices[0].message.content);

Python

python

from openai import OpenAIclient = OpenAI(  api_key=os.environ["GATEWAY_KEY"],  base_url="https://api.toygate.store/v1",)resp = client.chat.completions.create(  model="gpt-5.5",  messages=[{"role": "user", "content": "Say hi"}],)print(resp.choices[0].message.content)

Ожидаемый ответ

Стандартный ответ chat completion. Поле model повторяет запрошенный слаг, choices[0] содержит сообщение ассистента, а usage — число prompt и completion tokens.

Шлюз скрыл фактического провайдера: клиентскому коду не нужно знать, какой upstream выполнил запрос.

Дальнейшие шаги

Основные понятия — слаги моделей и детали, которые скрывает шлюз.
Аутентификация — bearer-токены, ротация и общедоступный каталог.
Потоковые ответы — Server-Sent Events, таймауты простоя и отмена.
Ошибки — оболочка ошибки и стабильные коды.
Лимиты и квоты — request rate, concurrency, баланс AI-кредитов и действия при превышении.

Самостоятельный хостинг

ToyGate имеет открытый исходный код и может быть развёрнут самостоятельно. Production compose-файл находится в docker-compose.prod.yml в корне репозитория. После запуска используйте инструкции из docs/how-to/ops/ для backup/restore, alerting, обновления сертификатов и incident response.