API-референс

Аутентификация

Все запросы авторизуются API-ключом в заголовке Authorization: Bearer sk-aigate-…. Ключ создаётся в личном кабинете. Базовый адрес — https://ai-gatewey.ru/v1.

POST/v1/chat/completions

Ответ в чате

Основной эндпоинт: принимает историю сообщений и возвращает ответ модели.

Параметры

Параметр	Тип	Обяз.	Описание
model	string	да	Код модели из каталога (например, deepseek/deepseek-chat).
messages	array	да	Массив сообщений { role, content }; role — system \| user \| assistant.
temperature	number	нет	0–2, «креативность» ответа. По умолчанию 1.
max_tokens	integer	нет	Ограничение длины ответа в токенах.
stream	boolean	нет	Потоковая передача ответа (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-chat",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)

Ответ

response.json

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek/deepseek-chat",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Привет! Чем могу помочь?" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 8, "completion_tokens": 6, "total_tokens": 14 }
}

GET/v1/models

Список моделей

Возвращает модели, доступные вашему ключу (в поле data[].id). Полный каталог с ценами — на странице Модели.

Коды ошибок

Код	Значение
401	Неверный или отсутствующий ключ.
402	Исчерпана месячная квота или баланс.
429	Превышен лимит запросов (RPM) или параллельных запросов.
400	Модель недоступна ключу либо неверный запрос.
5xx	Временная ошибка шлюза или апстрим-провайдера.