API нейросетей с оплатой в BYN
GPT, Claude, Gemini, DeepSeek и другие модели через один ключ. Формат OpenAI Chat Completions: подключаются официальные библиотеки OpenAI для Python, Node.js и PHP.
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.gpt-chat.by/api",
) Если код уже работает с OpenAI, поменяйте две строки: ключ и base_url = https://api.gpt-chat.by/api. Слаги моделей и цены — в списке моделей или в ответе GET /api/ai-models.
# pip install openai
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.gpt-chat.by/api",
)
response = client.chat.completions.create(
model="anthropic/claude-sonnet-latest",
messages=[{"role": "user", "content": "Привет! Как дела?"}],
)
print(response.choices[0].message.content)
# Потоковый ответ
stream = client.chat.completions.create(
model="anthropic/claude-sonnet-latest",
messages=[{"role": "user", "content": "Напиши короткое стихотворение"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")stream) последний кусок служебный и может прийти с пустым choices. Поэтому в примерах стоит проверка — без неё обращение к первому элементу choices упадёт. usage.cost_byn. Если баланса не хватает на оценку запроса — ошибка 402. Все запросы используют Bearer-токен в заголовке Authorization. Ключи создаются и отзываются в разделе API Ключи личного кабинета.
Authorization: Bearer YOUR_API_KEY Ошибки приходят одним объектом с полем message — его достаточно, чтобы показать человеку причину. Если ошибка относится к конкретным полям запроса, рядом лежит errors с разбивкой.
Исключение — запрос совсем без заголовка Authorization: тогда 401 приходит без message, в виде {"type": "…", "title": "An error occurred", "status": 401, "detail": "Unauthorized"}. Поэтому сначала смотрите на код ответа, а потом на тело.
{
"message": "Запрос отправлен к модели `nope/nope` которой нет, проверьте на сайте поддерживаемые модели https://gpt-chat.by/pricing",
"errors": [
{ "field": "model", "message": "Запрос отправлен к модели `nope/nope` которой нет..." }
]
}| Код | Когда |
|---|---|
400 | Неверный запрос: неизвестная модель, пустой или слишком длинный промпт, неподдерживаемый файл, нарушение любых ограничений полей |
401 | Нет заголовка Authorization (тело без message, см. выше), ключ не найден, отозван или просрочен. Без ключа отвечает только бесплатная klepa/free |
402 | Не хватает баланса на оценочную стоимость запроса. В теле есть balance, estimatedCost и shortfall |
403 | Ключ есть, но доступа к этому ресурсу нет |
404 | Объект не найден: чужая или удалённая коллекция, истёкшая задача генерации |
429 | Слишком часто. Действует на распознавание речи, презентации и разбор брендбука |
500 | Ошибка на нашей стороне — запрос можно повторить |
Запросы строятся на основе массива messages. Каждое сообщение имеет role (system/user/assistant) и content.
import requests
url = "https://api.gpt-chat.by/api/chat/completions"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
data = {
"model": "google/gemma-4",
"messages": [{"role": "user", "content": "Привет! Как дела?"}]
}
response = requests.post(url, headers=headers, json=data)
print(response.json())Пример ответа
{
"id": "chatcmpl-123",
"choices": [{
"message": {
"role": "assistant",
"content": "Привет! У меня всё отлично, чем могу помочь?"
}
}]
}Эндпоинты
https://api.gpt-chat.by/api/ai-modelsЕдинственный достоверный источник слагов для параметра model: сейчас в каталоге 41 чат-модель (служебная запись embedding для /chat/completions не подходит). Авторизация не нужна. Каталоги по типам генерации лежат на отдельных путях: /api/ai-models/images — генерация и редактирование картинок (15), /api/ai-models/videos — видео (21), /api/ai-models/audio — озвучка и музыка (7), /api/ai-models/transcribe — распознавание речи. Слаги из разных каталогов не взаимозаменяемы: модель для /chat/video не подойдёт для /chat/completions.
Параметры запроса
Параметры отсутствуют
Ответы
https://api.gpt-chat.by/api/chat/completionsОтправляет сообщения в AI модель и возвращает ответ. Совместимо с OpenAI Chat Completions API. Перед вашими сообщениями сервис подставляет свой системный промпт: он просит модель рассуждать по-английски, а отвечать на языке пользователя (по умолчанию — русском), и при enableSearch=true добавляет текущую дату с требованием брать факты из результатов поиска. Этот промпт входит в prompt_tokens (~30 токенов) и не отключается — если нужен другой язык ответа, задайте его своим сообщением с role=system или прямо в тексте запроса.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
messages | array | required | — | Массив сообщений, формирующих диалог. Поддерживает текст, изображения и вызов инструментов. |
model | string | — | openai/gpt-luna-latest | Слаг модели AI (например, google/gemma-4, anthropic/claude-opus-latest, openai/gpt-sol-latest). Полный список слагов — на /pricing или через GET /api/ai-models. |
collectionId | uuid | — | — | Идентификатор коллекции RAG для использования ваших документов |
temperature | number | — | 0.1 | Температура генерации (0.1 — 1.0) |
stream | boolean | — | false | Использовать потоковую передачу данных. Ответ идёт как text/event-stream: строки «data: {чанк}», последний чанк несёт usage, поток закрывается строкой «data: [DONE]» |
thinking | boolean | — | false | true включает размышления у моделей, которые их умеют (Claude, DeepSeek, Gemini, Qwen и другие). false и отсутствие поля оставляют модель в обычном режиме: часть моделей, в том числе все Claude, размышляет всегда. Токены размышлений входят в completion_tokens и оплачиваются как ответ. Текст размышлений, если модель его отдаёт, приходит в поле reasoning рядом с content |
reasoning_effort | string | — | — | Глубина размышлений: minimal, low, medium, high или xhigh (max равен xhigh). Действует у моделей с supports_reasoning_effort: true в GET /api/ai-models, остальным не передаётся. none и отсутствие поля оставляют модель на её обычном уровне. Если передан и thinking, главнее reasoning_effort. Чем выше уровень, тем больше токенов уходит на размышления — они оплачиваются как ответ. Другое значение — ошибка 400 с полем reasoning_effort |
max_tokens | integer | — | — | Потолок ответа в токенах, размышления входят в него. Больше предела модели (max_output в GET /api/ai-models) не уходит. Принимается и новое имя OpenAI — max_completion_tokens. Без поля модель отвечает со своим пределом. У моделей GPT и части других моделей потолок может не соблюдаться. Внимание: у моделей, которые размышляют (в том числе у всех Claude), маленький потолок может целиком уйти на размышления — тогда ответ придёт без текста, с finish_reason: length, а токены всё равно спишутся. Ставьте не меньше 1000 |
enableSearch | boolean | — | false | Включить поиск в интернете. Отвечает выбранная модель: Claude, DeepSeek и Qwen сами ищут до 5 раз за запрос, остальные — один поиск перед ответом |
searchOptions | object | — | null | Настройки веб-поиска: max_results (1–10, по умолчанию 10), engine (native | exa | parallel | perplexity — по умолчанию у Claude native, собственный поиск Anthropic, у остальных perplexity: ищет поисковый API, а отвечает выбранная вами модель), search_prompt (только для моделей с одним поиском) |
assistantId | uuid | — | — | Идентификатор вашего кастомного ассистента (персоны) — подставляет его системный промпт |
useMemory | boolean | — | true | Использовать долговременную память пользователя и сохранённые инструкции в контексте ответа |
imageConfig | object | — | — | Настройки выходной картинки для chat-capable image-моделей. Объект с полями aspect_ratio (1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9) и image_size (0.5K, 1K, 2K, 4K). modalities выставляются автоматически по модели. |
tools | array | — | — | Список инструментов (функций), которые может вызывать модель |
Ответы
https://api.gpt-chat.by/api/chat/imageСтоимость зависит от выбранной модели: цена в BYN за изображение — поле `price` в GET /api/ai-models/images. Списывается с баланса.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
prompt | string | required | — | Текстовое описание желаемого изображения (1—2000 символов) |
model | string | — | google/gemini-3.1-flash-image-preview | Слаг image-модели: google/gemini-2.5-flash-image, google/gemini-nano-banana-2.1, google/gemini-3.1-flash-image-preview, openai/gpt-5.4-image-2 и др. |
aspectRatio | string | — | — | Соотношение сторон: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9. Если не указано — решает модель. |
imageSize | string | — | — | Разрешение: 1K, 2K, 4K. Зависит от модели (для google/gemini-2.5-flash-image доступно только 1K). |
Ответы
https://api.gpt-chat.by/api/chat/image/editПринимает одно (image) или несколько (images[], до 3) исходных изображений и текстовое описание правки. Стоимость зависит от модели — поле `price` в GET /api/ai-models/images.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
prompt | string | required | — | Описание правки (5—600 символов) |
image | file | на выбор | — | Одно исходное изображение (JPG, PNG, WebP), максимум 10 МБ |
images[] | file[] | на выбор | — | Несколько исходных изображений (JPG, PNG, WebP), до 5 файлов, каждый ≤10 МБ, вместе ≤30 МБ. Используйте вместо image для мультиизображений. |
model | string | — | google/gemini-3.1-flash-image-preview | Слаг image-модели для редактирования |
Ответы
https://api.gpt-chat.by/api/chat/videoВозвращает taskId для поллинга через GET /api/chat/video/status/{taskId}. Длительность, разрешение и стоимость зависят от выбранной модели.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
prompt | string | required | — | Текстовое описание видео (1—2000 символов) |
model | string | — | alibaba/wan-2.6 | Слаг видео-модели: alibaba/wan-2.6, alibaba/wan-3.0, google/veo-3.1, google/veo-3.1-fast, google/veo-3.1-lite, google/gemini-omni-1.2-flash, bytedance/seedance-1-5-pro, bytedance/seedance-2.0, bytedance/seedance-2.0-fast, black-forest-labs/flux-3-video, kwaivgi/kling-v3.0-pro, kwaivgi/kling-v3.0-std, x-ai/grok-imagine-video-1.5-lite. |
resolution | string | — | — | Разрешение: 480p, 720p, 1080p. Набор зависит от модели; если не указано — берётся дефолт модели. |
duration | integer | — | — | Длительность в секундах. Допустимые значения зависят от модели; если не указано — дефолт модели. |
Ответы
https://api.gpt-chat.by/api/chat/video/imageПринимает исходное изображение и описание движения. Возвращает taskId для поллинга. Стоимость зависит от выбранной модели.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
image | file | required | — | Исходный файл (JPG, PNG, WebP), максимум 10 МБ |
prompt | string | required | — | Описание желаемого движения/анимации (5—600 символов) |
model | string | — | alibaba/wan-2.6 | Слаг видео-модели с поддержкой image-to-video: alibaba/wan-2.6, alibaba/wan-3.0, google/veo-3.1, google/veo-3.1-fast, google/veo-3.1-lite, google/gemini-omni-1.2-flash, bytedance/seedance-1-5-pro, bytedance/seedance-2.0, black-forest-labs/flux-3-video, kwaivgi/kling-v3.0-pro и др. |
resolution | string | — | — | Разрешение: 480p, 720p, 1080p. Набор зависит от модели; если не указано — дефолт модели. |
duration | integer | — | — | Длительность в секундах. Допустимые значения зависят от модели; если не указано — дефолт модели. |
Ответы
https://api.gpt-chat.by/api/chat/video/status/{taskId}Поллинг задачи. Когда status="done", в первом ответе вернётся HTTPS-ссылка на mp4 и обновлённый баланс. Дальше задача считается доставленной.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
taskId | string | required | — | Идентификатор задачи, полученный при вызове /chat/video или /chat/video/image |
Ответы
https://api.gpt-chat.by/api/chat/voice/transcribeПринимает короткое аудио (≤1 МБ, ~60 секунд). Rate-limited.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
voice | file | required | — | Аудиофайл (webm, ogg, mp3, wav, mp4, m4a), максимум 1 МБ |
Ответы
https://api.gpt-chat.by/api/chat/audioОзвучивает текст или генерирует аудио по описанию. Возвращает аудио как data-URL и ссылку на файл, а также транскрипт. Списывает баланс согласно длительности и модели.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
prompt | string | required | — | Текст для озвучивания или описание для генерации аудио (от 1 до 4000 символов) |
model | string | — | openai/gpt-audio-mini | Модель озвучки: openai/gpt-audio-mini, openai/gpt-audio, google/gemini-3.1-flash-tts-preview, hexgrad/kokoro-82m, mistralai/voxtral-mini-tts-2603; музыка: google/lyria-3-* |
voice | string | — | alloy | Голос озвучивания для моделей OpenAI: alloy, ash, ballad, coral, echo, fable, onyx, nova, sage, shimmer, verse. Если не указан — используется alloy |
duration | number | — | 30 | Длительность аудио в секундах (до 300; для каждой модели свой максимум) |
format | string | — | mp3 | Формат выходного аудио: mp3, wav, opus, flac |
imageUrl | url | — | — | Ссылка на изображение-референс (поддерживается только моделями Google Lyria) |
Ответы
https://api.gpt-chat.by/api/chat/file/extractПринимает документ и возвращает извлечённый текст. Текст обрезается до 200 000 символов.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
file | file | required | — | Документ: pdf, doc, docx, odt, rtf, fb2, pptx, ppt, odp, csv, tsv, xls, xlsx, ods, txt, md, markdown, json, xml, yaml, yml, log, cs, py, js, mjs, ts, tsx, jsx, vue, php, java, kt, swift, go, rb, rs, c, cpp, h, hpp, sql, sh, bash, ps1, css, scss, less, ini, toml, conf, html, htm. Максимум 50 МБ |
Ответы
https://api.gpt-chat.by/api/rag/collectionsСоздаёт новую коллекцию — папку раздела «Мои файлы», по документам которой модель будет отвечать (дообучения модели не происходит)
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
name | string | required | — | Название коллекции |
Ответы
https://api.gpt-chat.by/api/rag/collectionsВозвращает список всех коллекций текущего пользователя
Параметры запроса
Параметры отсутствуют
Ответы
https://api.gpt-chat.by/api/rag/collections/{collectionId}Возвращает информацию о конкретной коллекции
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
collectionId | uuid | required | — | Идентификатор коллекции |
Ответы
https://api.gpt-chat.by/api/rag/collections/{collectionId}Обновляет название коллекции и, при необходимости, привязывает Telegram-бота
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
collectionId | uuid | required | — | Идентификатор коллекции |
name | string | — | — | Новое название коллекции |
telegramToken | string | — | — | Токен Telegram-бота вида <bot_id>:<token> для отправки уведомлений |
Ответы
https://api.gpt-chat.by/api/rag/collections/{collectionId}Удаляет коллекцию и все связанные с ней документы
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
collectionId | uuid | required | — | Идентификатор коллекции |
Ответы
https://api.gpt-chat.by/api/rag/collections/{collectionId}/documentsДобавляет новый документ в указанную коллекцию
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
collectionId | uuid | required | — | Идентификатор коллекции |
url | url | на выбор | — | Ссылка на интернет ресурс (имя документа берётся из URL) |
file | file | на выбор | — | Файл: pdf, doc, docx, odt, rtf, fb2, pptx, ppt, odp, csv, tsv, xls, xlsx, ods, txt, md, markdown, json, xml, yaml, yml, log, cs, py, js, mjs, ts, tsx, jsx, vue, php, java, kt, swift, go, rb, rs, c, cpp, h, hpp, sql, sh, bash, ps1, css, scss, less, ini, toml, conf, html, htm. Максимум 50 MB (имя документа берётся из имени файла) |
Ответы
https://api.gpt-chat.by/api/rag/collections/{collectionId}/documents/{documentId}Удаляет конкретный документ из коллекции
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
collectionId | uuid | required | — | Идентификатор коллекции |
documentId | uuid | required | — | Идентификатор документа |
Ответы
https://api.gpt-chat.by/api/assistantsВозвращает ассистентов (персон) аккаунта. Поле id отсюда подставляется в параметр assistantId у POST /api/chat/completions.
Параметры запроса
Параметры отсутствуют
Ответы
https://api.gpt-chat.by/api/assistantsСоздаёт персону с собственным системным промптом.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
name | string | required | — | Название ассистента |
systemPrompt | string | required | — | Системный промпт персоны |
description | string | — | — | Короткое описание |
model | string | — | — | Модель по умолчанию (слаг из GET /api/ai-models) |
icon | string | — | — | Имя иконки для интерфейса |
Ответы
https://api.gpt-chat.by/api/assistants/{assistantId}Полностью перезаписывает поля ассистента. Чужой id даёт 404.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
assistantId | uuid | required | — | Идентификатор ассистента |
name | string | required | — | Название ассистента |
systemPrompt | string | required | — | Системный промпт персоны |
Ответы
https://api.gpt-chat.by/api/assistants/{assistantId}Удаляет персону аккаунта.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
assistantId | uuid | required | — | Идентификатор ассистента |
Ответы
https://api.gpt-chat.by/api/profile/memoryФакты и инструкции, которые подмешиваются в контекст при useMemory=true в POST /api/chat/completions.
Параметры запроса
Параметры отсутствуют
Ответы
https://api.gpt-chat.by/api/profile/memoryДобавляет факт или инструкцию в долговременную память аккаунта.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
content | string | required | — | Текст записи |
Ответы
https://api.gpt-chat.by/api/profile/memory/{memoryId}Удаляет одну запись долговременной памяти.
Параметры запроса
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
memoryId | uuid | required | — | Идентификатор записи |