Загружаем документацию…
Загружаем документацию…
AI Gateway предоставляет единый OpenAI-совместимый API. Если у вас есть код под OpenAI, достаточно поменять base_url и ключ. Прозаический гайд — на странице Документация.
Все запросы авторизуются API-ключом в заголовке Authorization: Bearer sk-aigate-…. Ключ создаётся в личном кабинете. Базовый адрес — https://ai-gatewey.ru/v1.
POST /v1/chat/completions HTTP/1.1Host: ai-gatewey.ruAuthorization: Bearer sk-aigate-…Content-Type: application/json/v1/chat/completionsОсновной эндпоинт: принимает историю сообщений и возвращает ответ модели.
modelКод модели из каталога (например, deepseek/deepseek-v4-flash).
messagesМассив сообщений { role, content }; role — system | user | assistant.
temperature0–2, «креативность» ответа. По умолчанию 1.
max_tokensОграничение длины ответа в токенах.
streamПотоковая передача ответа (Server-Sent Events).
from openai import OpenAI
client = OpenAI(
base_url="https://ai-gatewey.ru/v1",
api_key="sk-aigate-ваш_ключ",
)
resp = client.chat.completions.create(
model="deepseek/deepseek-v4-flash",
messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content){"id": "chatcmpl-…","object": "chat.completion","model": "deepseek/deepseek-v4-flash","choices": [{"index": 0,"message": { "role": "assistant", "content": "Привет! Чем могу помочь?" },"finish_reason": "stop"}],"usage": { "prompt_tokens": 8, "completion_tokens": 6, "total_tokens": 14 }}/v1/modelsВозвращает модели, доступные вашему ключу (в поле data[].id). Полный каталог с ценами — на странице Модели.
curl https://ai-gatewey.ru/v1/models \-H "Authorization: Bearer sk-aigate-ваш_ключ"/v1/messagesТот же шлюз принимает запросы в формате Anthropic Messages — для инструментов, которые умеют работать только с ним (Claude Code, SDK anthropic). Ключ, тарификация, лимиты и каталог моделей — общие с /v1/chat/completions: в поле model указывается код из каталога, а не имя модели Anthropic.
Доступны и остальные OpenAI-совместимые пути шлюза — /v1/responses (встроенные инструменты — веб-поиск, computer use — не поддерживаются) и /v1/images/generations; набор моделей для них определяется каталогом.
Модели, помеченные в каталоге как аудио, принимают звук на вход через тот же /v1/chat/completions — отдельного пути для них не требуется.
export ANTHROPIC_BASE_URL=https://ai-gatewey.ru
export ANTHROPIC_AUTH_TOKEN=sk-aigate-ваш_ключ
export ANTHROPIC_MODEL=anthropic/claude-sonnet-5.5
# фоновые задачи Claude Code (заголовки сессий и прочая служебка) идут в haiku —
# без этой строки они уйдут в идентификатор Anthropic, которого в каталоге нет
export ANTHROPIC_DEFAULT_HAIKU_MODEL=anthropic/claude-haiku-latest
claudeВместо опроса API можно подписаться на события: мы отправим POST с подписью HMAC-SHA256 в заголовке X-AIGateway-Signature. Адреса настраиваются в кабинете.
Формат заголовков доставки, пример проверки подписи и правила повторов — в разделе «Вебхуки» документации: код проверки живёт там одним экземпляром, чтобы не расходиться с этой страницей.
Песочница отправляет тот же POST /v1/chat/completions с вашим ключом — ответ и расход видно сразу.