API для разработчиков

Платформа отдаёт OpenAI-совместимый API — подходит любой SDK и инструмент, умеющий работать с OpenAI (официальные SDK, LangChain, LiteLLM, n8n и т.д.).

Endpoint и ключ

• Base URL: https://api.zubriq.by/v1
• Ключ выпускается в кабинете: раздел API-ключей вашей организации. Ключ показывается один раз — сохраните его.
• У ключа может быть свой список моделей вместо всего уровня доступа: при выпуске выбирается «Все модели уровня» или «Только выбранные» (с поиском), у действующего ключа список правится пунктом «Модели ключа…» в меню ключа (Настройки → Ключи API); в списке ключей такой ключ отмечен бейджем «N моделей» — имена моделей видны в подсказке. Менять список моделей и отзывать ключ может тот, кто выпустил ключ, и владелец организации.

Кроме OpenAI-формата шлюз понимает Anthropic Messages (/v1/messages) и OpenAI Responses (/v1/responses) — через них работают сторонние кодинг-агенты: Сторонние агенты на ключе ZuBrIQ.

Пример: curl

curl https://api.zubriq.by/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<имя модели>",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Список доступных моделей: GET https://api.zubriq.by/v1/models (с тем же заголовком авторизации). Наши модели: zubr (Zubr Local, в контуре РБ), zubr-flash (Zubr Flash), zubr-coder — Zubr Pro (Zubr Max по API — это zubr-coder с reasoning_effort: max), zubr-image (Zubr Image); расшифровка имён — на странице «Имена моделей». Актуальные цены — на zubriq.by. Тарифы на чат (Free, Lite, Pro, Max, Team) на API не действуют: ключи оплачиваются по токенам с баланса — Тарифы и лимиты.

Пример: OpenAI SDK (Python)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.zubriq.by/v1",
    api_key="sk-...",
)

resp = client.chat.completions.create(
    model="<имя модели>",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)

Лимиты и расход

Расход считается по токенам (озвучка — по символам) и виден в кабинете. У триала — фиксированный бюджет; когда он исчерпан, ключ перестаёт отвечать — свяжитесь с нами для перехода на договор.

Озвучка текста (TTS)

Синтез речи — тем же ключом, метод POST /v1/audio/speech (как у OpenAI). Ответ — аудиофайл WAV (24 кГц, моно).

Модель	Что это
gemini-3.8-flash-tts	Gemini 3.8 Flash TTS (Google) — естественное звучание, русский и английский
gemini-3.8-flash-lite-tts	Gemini 3.8 Flash-Lite TTS (Google) — дешевле, для массовой озвучки

curl https://api.zubriq.by/v1/audio/speech \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.8-flash-tts",
    "input": "Добрый день! Ваш запрос зарегистрирован.",
    "voice": "Kore"
  }' \
  --output speech.wav

from openai import OpenAI

client = OpenAI(base_url="https://api.zubriq.by/v1", api_key="sk-...")
with client.audio.speech.with_streaming_response.create(
    model="gemini-3.8-flash-tts",
    voice="Kore",
    input="Добрый день! Ваш запрос зарегистрирован.",
) as resp:
    resp.stream_to_file("speech.wav")

voice — голос Gemini: Kore, Puck, Charon, Aoede, Fenrir, Leda и др.

Оплата — за символы текста без пробелов, с баланса организации. Цена за 1000 символов — на zubriq.by/pricing; час речи — около 43 000 символов русского текста. Текст для озвучки передаётся поставщику модели (Google).

Генерация музыки

Кроме текстовых моделей платформа умеет создавать песни из текста — тем же ключом: Music API.

ZubrCode

Для работы из терминала есть готовый кодинг-агент ZubrCode, преднастроенный на API платформы: установка и вход; тот же агент с вашим репозиторием доступен прямо в чате.