Разделы документации

Начало

Текст

Изображения

Генерация изображенийскоро
- Редактированиескоро
- Форматы и размерыскоро

Видео

Генерация видеоскоро

Голос

Обзорскоро

Инструменты

Обзорскоро

Режимы обработки

Справочник

Документация API

Изображения (images)готовится

Планируемый контракт POST /v1/images/generations и /v1/images/edits, цены

Раздела images в API пока нет. Эндпоинты POST /v1/images/generations и POST /v1/images/edits сейчас не отвечают — вызвать их нельзя. Всё, что описано ниже, это планируемый контракт: мы держим ту же конвенцию, что и в уже работающем /v1/chat/completions (совместимость с OpenAI), поэтому имена полей и форма ответа — разумное умолчание, а не факт. Пока раздел не выпущен, поля и значения могут измениться. Работают только POST /v1/chat/completions и GET /v1/models.

Генерация изображения

Планируемый адрес: POST https://api.librachat.kz/v1/images/generations. Авторизация та же, что и везде: заголовок Authorization: Bearer sk-libra-… . Тело — JSON.

Поле	Тип	По умолчанию	Описание
prompt	строка	обязательное	Описание картинки на русском или английском. Планируемый предел — 4 000 знаков.
model	строка	libra-image	Модель генерации. Пока предполагается одно значение — libra-image.
n	целое	1	Сколько картинок сгенерировать за один запрос. Планируемый предел — 4.
size	строка	1K	Размер: 1K или 2K. Влияет на цену при высоком качестве.
quality	строка	standard	standard — стандартное качество, high — высокое. Влияет на цену.
response_format	строка	url	url — ссылка на файл, b64_json — картинка строкой base64 прямо в ответе.
user	строка	—	Ваш внутренний идентификатор пользователя. Попадает в журнал операций.

Ссылки в режиме url планируются временными — рассчитывайте скачать файл сразу после ответа. Если файл нужен надолго, используйте b64_json и храните у себя.

bash

curl https://api.librachat.kz/v1/images/generations \
  -H "Authorization: Bearer $LIBRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "libra-image",
    "prompt": "Кофейня в старом дворе, утренний свет, вид сверху",
    "n": 1,
    "size": "1K",
    "quality": "high",
    "response_format": "url"
  }'

python

import os, requests

BASE = "https://api.librachat.kz/v1"
headers = {"Authorization": f"Bearer {os.environ['LIBRA_API_KEY']}"}

resp = requests.post(
    f"{BASE}/images/generations",
    headers=headers,
    json={
        "model": "libra-image",
        "prompt": "Кофейня в старом дворе, утренний свет, вид сверху",
        "n": 1,
        "size": "1K",
        "quality": "high",
        "response_format": "url",
    },
    timeout=120,
)
resp.raise_for_status()
print(resp.json()["data"][0]["url"])

Планируемый ответ повторяет привычную форму: объект с полем created и массивом data. В каждом элементе — url или b64_json, и revised_prompt, если описание было уточнено перед генерацией.

json

{
  "created": 1770000000,
  "data": [
    {
      "url": "https://cdn.librachat.kz/img/9f2c….png",
      "revised_prompt": "Кофейня в старом дворе, мягкий утренний свет, вид сверху"
    }
  ]
}

Ошибки планируются те же, что и в текстовом API: 401 no_api_key, 401 invalid_api_key, 402 insufficient_balance, 429 rate_limited, 502 upstream_error. Отдельно ожидается 400 на слишком длинный prompt и на неизвестное значение size или quality.

Редактирование готовой картинки

Отдельный планируемый эндпоинт: POST /v1/images/edits. Он принимает multipart/form-data, а не JSON, потому что вы прикладываете файл.

Поле	Тип	Описание
image	файл	Исходная картинка (PNG или JPEG). Планируемый предел размера — 20 МБ.
mask	файл	Необязательно. Маска с прозрачной областью: перерисовывается только она.
prompt	строка	Что должно оказаться в изменённой области или на всей картинке.
model	строка	libra-image.
n	целое	Сколько вариантов вернуть.
size	строка	1K или 2K — размер результата.
response_format	строка	url или b64_json.

bash

curl https://api.librachat.kz/v1/images/edits \
  -H "Authorization: Bearer $LIBRA_API_KEY" \
  -F model="libra-image" \
  -F image="@room.png" \
  -F mask="@room-mask.png" \
  -F prompt="Поставить у окна деревянный стол" \
  -F n=1 \
  -F size="1K" \
  -F response_format="url"

Важно по деньгам: при редактировании планируется оплачивать и результат (как генерацию), и исходную картинку на входе — 2,70 ₽ за штуку. Если вы отправляете один файл и просите 2 варианта, вы платите за один вход и за два изображения на выходе.

Цены

Цены в рублях, за одно изображение. Списание планируется с общего предоплаченного баланса аккаунта, каждая операция попадает в журнал.

Что тарифицируется	Единица	Цена, ₽
Изображение стандартное	за штуку	0,54
Изображение высокого качества, 1K	за штуку	13,50
Изображение высокого качества, 2K	за штуку	18,90
Картинка на входе (редактирование)	за штуку	2,70
Пакетная обработка	к ставкам выше	−20%
Приоритетная обработка	к ставкам выше	×2
Хранение файлов	за ГиБ в сутки	6,75
Скачивание файлов	за ГиБ	54,00

Пополнение баланса — от 1 млн токенов по 450 ₽ за 1 млн. То есть одно изображение высокого качества 2K по нынешним ставкам стоит примерно столько же, сколько 42 000 токенов текста.

Лимиты

Ограничение по частоте у ключа общее — 120 запросов в минуту. Лимит в 1 000 000 токенов в минуту к картинкам не относится: генерация не измеряется токенами, для неё нужен свой счётчик. Планируемое отдельное ограничение — не более 8 изображений в минуту на ключ (n суммируется), чтобы один ключ не занял всю очередь генерации.

НазадПотоковая передача ДальшеРедактирование

Изображения (images)готовится

Планируемый контракт POST /v1/images/generations и /v1/images/edits, цены

Генерация изображения

Поле	Тип	По умолчанию	Описание
prompt	строка	обязательное	Описание картинки на русском или английском. Планируемый предел — 4 000 знаков.
model	строка	libra-image	Модель генерации. Пока предполагается одно значение — libra-image.
n	целое	1	Сколько картинок сгенерировать за один запрос. Планируемый предел — 4.
size	строка	1K	Размер: 1K или 2K. Влияет на цену при высоком качестве.
quality	строка	standard	standard — стандартное качество, high — высокое. Влияет на цену.
response_format	строка	url	url — ссылка на файл, b64_json — картинка строкой base64 прямо в ответе.
user	строка	—	Ваш внутренний идентификатор пользователя. Попадает в журнал операций.

bash

curl https://api.librachat.kz/v1/images/generations \
  -H "Authorization: Bearer $LIBRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "libra-image",
    "prompt": "Кофейня в старом дворе, утренний свет, вид сверху",
    "n": 1,
    "size": "1K",
    "quality": "high",
    "response_format": "url"
  }'

python

import os, requests

BASE = "https://api.librachat.kz/v1"
headers = {"Authorization": f"Bearer {os.environ['LIBRA_API_KEY']}"}

resp = requests.post(
    f"{BASE}/images/generations",
    headers=headers,
    json={
        "model": "libra-image",
        "prompt": "Кофейня в старом дворе, утренний свет, вид сверху",
        "n": 1,
        "size": "1K",
        "quality": "high",
        "response_format": "url",
    },
    timeout=120,
)
resp.raise_for_status()
print(resp.json()["data"][0]["url"])

json

{
  "created": 1770000000,
  "data": [
    {
      "url": "https://cdn.librachat.kz/img/9f2c….png",
      "revised_prompt": "Кофейня в старом дворе, мягкий утренний свет, вид сверху"
    }
  ]
}

Редактирование готовой картинки

Поле	Тип	Описание
image	файл	Исходная картинка (PNG или JPEG). Планируемый предел размера — 20 МБ.
mask	файл	Необязательно. Маска с прозрачной областью: перерисовывается только она.
prompt	строка	Что должно оказаться в изменённой области или на всей картинке.
model	строка	libra-image.
n	целое	Сколько вариантов вернуть.
size	строка	1K или 2K — размер результата.
response_format	строка	url или b64_json.

bash

curl https://api.librachat.kz/v1/images/edits \
  -H "Authorization: Bearer $LIBRA_API_KEY" \
  -F model="libra-image" \
  -F image="@room.png" \
  -F mask="@room-mask.png" \
  -F prompt="Поставить у окна деревянный стол" \
  -F n=1 \
  -F size="1K" \
  -F response_format="url"

Цены

Что тарифицируется	Единица	Цена, ₽
Изображение стандартное	за штуку	0,54
Изображение высокого качества, 1K	за штуку	13,50
Изображение высокого качества, 2K	за штуку	18,90
Картинка на входе (редактирование)	за штуку	2,70
Пакетная обработка	к ставкам выше	−20%
Приоритетная обработка	к ставкам выше	×2
Хранение файлов	за ГиБ в сутки	6,75
Скачивание файлов	за ГиБ	54,00