GPT Chat — нейросеть без VPN в Беларуси и России
API для разработчиков

API нейросетей с оплатой в BYN

GPT, Claude, Gemini, DeepSeek и другие модели через один ключ. Формат OpenAI Chat Completions: подключаются официальные библиотеки OpenAI для Python, Node.js и PHP.

main.py
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.gpt-chat.by/api",
)
Формат OpenAI
Работают официальные библиотеки OpenAI для Python, Node.js и PHP: меняете ключ и base_url, остальной код прежний.
41 текстовая модель
GPT, Claude, Gemini, DeepSeek, Grok, Qwen и другие. Плюс 15 моделей картинок и 21 — видео.
Оплата в BYN
Общий баланс, пополнение от 5 BYN картой. Без VPN и иностранной карты, списание по факту, без подписки.
Поток, картинки, инструменты
Потоковые ответы (stream), картинки на вход, вызов инструментов (tools), генерация картинок и видео.
Подключение за минуту

Если код уже работает с 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="")
Лимиты и расходы
Частота
У запросов к чату с ключом нет отдельного лимита в минуту. Потолок задают баланс и «Лимит расходов»: его можно поставить каждому ключу в разделе API Ключи при создании ключа.
Ошибка 429
Только у распознавания речи и презентаций (2 запроса в минуту) и у разбора брендбука (2 запроса за 5 минут).
Списание
С общего баланса в BYN по факту, подписки нет. Стоимость каждого ответа приходит в usage.cost_byn. Если баланса не хватает на оценку запроса — ошибка 402.
Пополнение
От 5 BYN картой БЕЛКАРТ, Visa, Mastercard или МИР. Без VPN и иностранной карты.
Авторизация

Все запросы используют 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())

Пример ответа

JSON
{
  "id": "chatcmpl-123",
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "Привет! У меня всё отлично, чем могу помочь?"
    }
  }]
}

Эндпоинты

GET
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.

Параметры запроса

Параметры отсутствуют

Ответы

POST
https://api.gpt-chat.by/api/chat/completions
Chat completions

Отправляет сообщения в AI модель и возвращает ответ. Совместимо с OpenAI Chat Completions API. Перед вашими сообщениями сервис подставляет свой системный промпт: он просит модель рассуждать по-английски, а отвечать на языке пользователя (по умолчанию — русском), и при enableSearch=true добавляет текущую дату с требованием брать факты из результатов поиска. Этот промпт входит в prompt_tokens (~30 токенов) и не отключается — если нужен другой язык ответа, задайте его своим сообщением с role=system или прямо в тексте запроса.

Параметры запроса

json/body
ПараметрТипОбязательныйПо умолчаниюОписание
messagesarray
required
—Массив сообщений, формирующих диалог. Поддерживает текст, изображения и вызов инструментов.
modelstring — openai/gpt-luna-latestСлаг модели AI (например, google/gemma-4, anthropic/claude-opus-latest, openai/gpt-sol-latest). Полный список слагов — на /pricing или через GET /api/ai-models.
collectionIduuid — —Идентификатор коллекции RAG для использования ваших документов
temperaturenumber — 0.1Температура генерации (0.1 — 1.0)
streamboolean — falseИспользовать потоковую передачу данных. Ответ идёт как text/event-stream: строки «data: {чанк}», последний чанк несёт usage, поток закрывается строкой «data: [DONE]»
thinkingboolean — falsetrue включает размышления у моделей, которые их умеют (Claude, DeepSeek, Gemini, Qwen и другие). false и отсутствие поля оставляют модель в обычном режиме: часть моделей, в том числе все Claude, размышляет всегда. Токены размышлений входят в completion_tokens и оплачиваются как ответ. Текст размышлений, если модель его отдаёт, приходит в поле reasoning рядом с content
reasoning_effortstring — —Глубина размышлений: minimal, low, medium, high или xhigh (max равен xhigh). Действует у моделей с supports_reasoning_effort: true в GET /api/ai-models, остальным не передаётся. none и отсутствие поля оставляют модель на её обычном уровне. Если передан и thinking, главнее reasoning_effort. Чем выше уровень, тем больше токенов уходит на размышления — они оплачиваются как ответ. Другое значение — ошибка 400 с полем reasoning_effort
max_tokensinteger — —Потолок ответа в токенах, размышления входят в него. Больше предела модели (max_output в GET /api/ai-models) не уходит. Принимается и новое имя OpenAI — max_completion_tokens. Без поля модель отвечает со своим пределом. У моделей GPT и части других моделей потолок может не соблюдаться. Внимание: у моделей, которые размышляют (в том числе у всех Claude), маленький потолок может целиком уйти на размышления — тогда ответ придёт без текста, с finish_reason: length, а токены всё равно спишутся. Ставьте не меньше 1000
enableSearchboolean — falseВключить поиск в интернете. Отвечает выбранная модель: Claude, DeepSeek и Qwen сами ищут до 5 раз за запрос, остальные — один поиск перед ответом
searchOptionsobject — nullНастройки веб-поиска: max_results (1–10, по умолчанию 10), engine (native | exa | parallel | perplexity — по умолчанию у Claude native, собственный поиск Anthropic, у остальных perplexity: ищет поисковый API, а отвечает выбранная вами модель), search_prompt (только для моделей с одним поиском)
assistantIduuid — —Идентификатор вашего кастомного ассистента (персоны) — подставляет его системный промпт
useMemoryboolean — trueИспользовать долговременную память пользователя и сохранённые инструкции в контексте ответа
imageConfigobject — —Настройки выходной картинки для 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 выставляются автоматически по модели.
toolsarray — —Список инструментов (функций), которые может вызывать модель

Ответы

POST
https://api.gpt-chat.by/api/chat/image
Сгенерировать изображение

Стоимость зависит от выбранной модели: цена в BYN за изображение — поле `price` в GET /api/ai-models/images. Списывается с баланса.

Параметры запроса

json/body
ПараметрТипОбязательныйПо умолчаниюОписание
promptstring
required
—Текстовое описание желаемого изображения (1—2000 символов)
modelstring — 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 и др.
aspectRatiostring — —Соотношение сторон: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9. Если не указано — решает модель.
imageSizestring — —Разрешение: 1K, 2K, 4K. Зависит от модели (для google/gemini-2.5-flash-image доступно только 1K).

Ответы

POST
https://api.gpt-chat.by/api/chat/image/edit
Отредактировать изображение

Принимает одно (image) или несколько (images[], до 3) исходных изображений и текстовое описание правки. Стоимость зависит от модели — поле `price` в GET /api/ai-models/images.

Параметры запроса

multipart/form-data
ПараметрТипОбязательныйПо умолчаниюОписание
promptstring
required
—Описание правки (5—600 символов)
imagefile
на выбор
—Одно исходное изображение (JPG, PNG, WebP), максимум 10 МБ
images[]file[]
на выбор
—Несколько исходных изображений (JPG, PNG, WebP), до 5 файлов, каждый ≤10 МБ, вместе ≤30 МБ. Используйте вместо image для мультиизображений.
modelstring — google/gemini-3.1-flash-image-previewСлаг image-модели для редактирования

Ответы

POST
https://api.gpt-chat.by/api/chat/video
Сгенерировать видео

Возвращает taskId для поллинга через GET /api/chat/video/status/{taskId}. Длительность, разрешение и стоимость зависят от выбранной модели.

Параметры запроса

json/body
ПараметрТипОбязательныйПо умолчаниюОписание
promptstring
required
—Текстовое описание видео (1—2000 символов)
modelstring — 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.
resolutionstring — —Разрешение: 480p, 720p, 1080p. Набор зависит от модели; если не указано — берётся дефолт модели.
durationinteger — —Длительность в секундах. Допустимые значения зависят от модели; если не указано — дефолт модели.

Ответы

POST
https://api.gpt-chat.by/api/chat/video/image
Видео из изображения

Принимает исходное изображение и описание движения. Возвращает taskId для поллинга. Стоимость зависит от выбранной модели.

Параметры запроса

multipart/form-data
ПараметрТипОбязательныйПо умолчаниюОписание
imagefile
required
—Исходный файл (JPG, PNG, WebP), максимум 10 МБ
promptstring
required
—Описание желаемого движения/анимации (5—600 символов)
modelstring — 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 и др.
resolutionstring — —Разрешение: 480p, 720p, 1080p. Набор зависит от модели; если не указано — дефолт модели.
durationinteger — —Длительность в секундах. Допустимые значения зависят от модели; если не указано — дефолт модели.

Ответы

GET
https://api.gpt-chat.by/api/chat/video/status/{taskId}
Статус видео-задачи

Поллинг задачи. Когда status="done", в первом ответе вернётся HTTPS-ссылка на mp4 и обновлённый баланс. Дальше задача считается доставленной.

Параметры запроса

path/string
ПараметрТипОбязательныйПо умолчаниюОписание
taskIdstring
required
—Идентификатор задачи, полученный при вызове /chat/video или /chat/video/image

Ответы

POST
https://api.gpt-chat.by/api/chat/voice/transcribe
Распознать речь

Принимает короткое аудио (≤1 МБ, ~60 секунд). Rate-limited.

Параметры запроса

multipart/form-data
ПараметрТипОбязательныйПо умолчаниюОписание
voicefile
required
—Аудиофайл (webm, ogg, mp3, wav, mp4, m4a), максимум 1 МБ

Ответы

POST
https://api.gpt-chat.by/api/chat/audio
Сгенерировать аудио

Озвучивает текст или генерирует аудио по описанию. Возвращает аудио как data-URL и ссылку на файл, а также транскрипт. Списывает баланс согласно длительности и модели.

Параметры запроса

json/body
ПараметрТипОбязательныйПо умолчаниюОписание
promptstring
required
—Текст для озвучивания или описание для генерации аудио (от 1 до 4000 символов)
modelstring — 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-*
voicestring — alloyГолос озвучивания для моделей OpenAI: alloy, ash, ballad, coral, echo, fable, onyx, nova, sage, shimmer, verse. Если не указан — используется alloy
durationnumber — 30Длительность аудио в секундах (до 300; для каждой модели свой максимум)
formatstring — mp3Формат выходного аудио: mp3, wav, opus, flac
imageUrlurl — —Ссылка на изображение-референс (поддерживается только моделями Google Lyria)

Ответы

POST
https://api.gpt-chat.by/api/chat/file/extract
Извлечь текст из файла

Принимает документ и возвращает извлечённый текст. Текст обрезается до 200 000 символов.

Параметры запроса

multipart/form-data
ПараметрТипОбязательныйПо умолчаниюОписание
filefile
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 МБ

Ответы

POST
https://api.gpt-chat.by/api/rag/collections
RAG: создать коллекцию

Создаёт новую коллекцию — папку раздела «Мои файлы», по документам которой модель будет отвечать (дообучения модели не происходит)

Параметры запроса

json/body
ПараметрТипОбязательныйПо умолчаниюОписание
namestring
required
—Название коллекции

Ответы

GET
https://api.gpt-chat.by/api/rag/collections
RAG: список коллекций

Возвращает список всех коллекций текущего пользователя

Параметры запроса

Параметры отсутствуют

Ответы

GET
https://api.gpt-chat.by/api/rag/collections/{collectionId}
RAG: получить коллекцию

Возвращает информацию о конкретной коллекции

Параметры запроса

path/string
ПараметрТипОбязательныйПо умолчаниюОписание
collectionIduuid
required
—Идентификатор коллекции

Ответы

PUT
https://api.gpt-chat.by/api/rag/collections/{collectionId}
RAG: изменить коллекцию

Обновляет название коллекции и, при необходимости, привязывает Telegram-бота

Параметры запроса

json/body + path/string
ПараметрТипОбязательныйПо умолчаниюОписание
collectionIduuid
required
—Идентификатор коллекции
namestring — —Новое название коллекции
telegramTokenstring — —Токен Telegram-бота вида <bot_id>:<token> для отправки уведомлений

Ответы

DELETE
https://api.gpt-chat.by/api/rag/collections/{collectionId}
RAG: удалить коллекцию

Удаляет коллекцию и все связанные с ней документы

Параметры запроса

path/string
ПараметрТипОбязательныйПо умолчаниюОписание
collectionIduuid
required
—Идентификатор коллекции

Ответы

POST
https://api.gpt-chat.by/api/rag/collections/{collectionId}/documents
RAG: загрузить документ

Добавляет новый документ в указанную коллекцию

Параметры запроса

multipart/form-data + path/string
ПараметрТипОбязательныйПо умолчаниюОписание
collectionIduuid
required
—Идентификатор коллекции
urlurl
на выбор
—Ссылка на интернет ресурс (имя документа берётся из URL)
filefile
на выбор
—Файл: 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 (имя документа берётся из имени файла)

Ответы

DELETE
https://api.gpt-chat.by/api/rag/collections/{collectionId}/documents/{documentId}
RAG: удалить документ

Удаляет конкретный документ из коллекции

Параметры запроса

json/body + path/string
ПараметрТипОбязательныйПо умолчаниюОписание
collectionIduuid
required
—Идентификатор коллекции
documentIduuid
required
—Идентификатор документа

Ответы

GET
https://api.gpt-chat.by/api/assistants
Ассистенты: список

Возвращает ассистентов (персон) аккаунта. Поле id отсюда подставляется в параметр assistantId у POST /api/chat/completions.

Параметры запроса

Параметры отсутствуют

Ответы

POST
https://api.gpt-chat.by/api/assistants
Ассистенты: создать

Создаёт персону с собственным системным промптом.

Параметры запроса

json/body
ПараметрТипОбязательныйПо умолчаниюОписание
namestring
required
—Название ассистента
systemPromptstring
required
—Системный промпт персоны
descriptionstring — —Короткое описание
modelstring — —Модель по умолчанию (слаг из GET /api/ai-models)
iconstring — —Имя иконки для интерфейса

Ответы

PUT
https://api.gpt-chat.by/api/assistants/{assistantId}
Ассистенты: изменить

Полностью перезаписывает поля ассистента. Чужой id даёт 404.

Параметры запроса

json/body + path/string
ПараметрТипОбязательныйПо умолчаниюОписание
assistantIduuid
required
—Идентификатор ассистента
namestring
required
—Название ассистента
systemPromptstring
required
—Системный промпт персоны

Ответы

DELETE
https://api.gpt-chat.by/api/assistants/{assistantId}
Ассистенты: удалить

Удаляет персону аккаунта.

Параметры запроса

path/string
ПараметрТипОбязательныйПо умолчаниюОписание
assistantIduuid
required
—Идентификатор ассистента

Ответы

GET
https://api.gpt-chat.by/api/profile/memory
Память: список

Факты и инструкции, которые подмешиваются в контекст при useMemory=true в POST /api/chat/completions.

Параметры запроса

Параметры отсутствуют

Ответы

POST
https://api.gpt-chat.by/api/profile/memory
Память: добавить

Добавляет факт или инструкцию в долговременную память аккаунта.

Параметры запроса

json/body
ПараметрТипОбязательныйПо умолчаниюОписание
contentstring
required
—Текст записи

Ответы

DELETE
https://api.gpt-chat.by/api/profile/memory/{memoryId}
Память: удалить

Удаляет одну запись долговременной памяти.

Параметры запроса

path/string
ПараметрТипОбязательныйПо умолчаниюОписание
memoryIduuid
required
—Идентификатор записи

Ответы