Гайды22 июня 2026 г.8 мин чтенияОбновлено 15 ноября 2026 г.
Генерация изображений через API: от текста до картинки
Как сгенерировать изображение через API: параметр modalities, получение base64-картинки из ответа, сохранение в файл на Python и цены в рублях.
Сгенерировать изображение через API можно тем же запросом, что и текст: выберите image-модель из каталога, добавьте в запрос параметр modalities: ["image", "text"] — и модель вернёт картинку строкой base64 прямо в ответе. Останется декодировать её и записать в файл. Ниже — рабочие примеры на curl и Python, советы по промптам и актуальные цены в рублях.
Что понадобится
Генерация изображений в Hubris работает через стандартный запрос /v1/chat/completions, поэтому подойдёт любой HTTP-клиент или официальная библиотека OpenAI. Для старта нужны три вещи:
- Аккаунт. Регистрация на странице входа по коду из письма — пароль придумывать не нужно.
- Ключ. Создаётся в разделе «Ключи» личного кабинета. Ключ начинается с
sk-gw-и показывается полностью только один раз — сразу сохраните его в переменную окружения. - Баланс. Пополняется в разделе «Биллинг»: по СБП, банковской картой или по счёту, если платит организация.
Подписки нет — средства списываются с баланса только за фактические генерации.
Какие модели генерируют изображения
В каталоге доступны две линейки моделей с выводом изображений:
- Nano Banana — линейка Google Gemini Image. Nano Banana 2 (
google/gemini-3.1-flash-image) вышла 26 февраля 2026 года: генерирует картинки до 4K, поддерживает 14 соотношений сторон и до 14 референсных изображений в одном запросе, сохраняет согласованность до пяти персонажей. Предыдущая Nano Banana (google/gemini-2.5-flash-image) остаётся в каталоге. Отдельно в линейке стоит Nano Banana Pro (google/gemini-3-pro-image), сфокусированная на студийном качестве: режим рассуждений, разрешение до 4K и более аккуратный рендеринг текста. - GPT Image — линейка OpenAI. GPT Image 2 (
openai/gpt-image-2) вышла 21 апреля 2026 года и новее моделей GPT-5 Image: понимает текстовые промпты и изображения-референсы, выдаёт до восьми согласованных картинок за запрос и точно рендерит надписи внутри изображения. Предыдущие GPT-5 Image (openai/gpt-5-image) и GPT-5 Image Mini (openai/gpt-5-image-mini) остаются в каталоге для совместимости.
Линейка Gemini в ответе возвращает и изображение, и текст; GPT Image 2 по данным каталога — только изображение. В запросе при этом всё равно указывается modalities: ["image", "text"]. Живой список с тарифами — в подборке моделей для изображений, а сравнить их с остальными можно в полном каталоге моделей.
Минимальный запрос: параметр modalities
Единственное отличие от текстового запроса — поле modalities. Запрос через curl выглядит так:
curl -s https://api.hubris.pw/v1/chat/completions \
-H "Authorization: Bearer sk-gw-..." \
-H "Content-Type: application/json" \
-d '{
"model": "google/gemini-3.1-flash-image",
"modalities": ["image", "text"],
"messages": [{"role": "user", "content": "Космический маяк среди звёзд, неоновое свечение, цифровая живопись"}]
}'Картинка приходит строкой base64 в поле choices[0].message.images[0].image_url.url:
{
"id": "chatcmpl-...",
"model": "google/gemini-3.1-flash-image",
"choices": [
{
"message": {
"role": "assistant",
"content": "Готово!",
"images": [
{
"type": "image_url",
"image_url": { "url": "data:image/png;base64,iVBORw0KGgo..." }
}
]
}
}
]
}Структура полностью совместима с форматом OpenAI Chat Completions — к сообщению ассистента добавляется только массив images. Разбор остальных параметров, включая потоковую передачу, — в документации по генерации изображений.
Сохраняем картинку в файл на Python
В официальной библиотеке openai поле modalities не объявлено в типах Chat Completions, поэтому его передают через extra_body. Полный пример — от запроса до файла на диске:
import base64
from openai import OpenAI
client = OpenAI(
base_url="https://api.hubris.pw/v1",
api_key="sk-gw-...",
)
resp = client.chat.completions.create(
model="google/gemini-3.1-flash-image",
messages=[{
"role": "user",
"content": "Маяк на скале в шторм, кинематографичный свет, цифровая живопись",
}],
extra_body={
"modalities": ["image", "text"],
"image_config": {"aspect_ratio": "16:9"},
},
)
images = resp.choices[0].message.model_extra.get("images", [])
for i, img in enumerate(images):
data_url = img["image_url"]["url"] # data:image/png;base64,...
header, b64 = data_url.split(",", 1)
ext = header.split("/")[1].split(";")[0] # png или jpeg
with open(f"image_{i}.{ext}", "wb") as f:
f.write(base64.b64decode(b64))
print(f"Сохранено: image_{i}.{ext}")Скрипт декодирует base64-строку, определяет расширение из заголовка data-URL и записывает каждую картинку в отдельный файл. Дополнительные библиотеки не нужны: base64 входит в стандартную поставку Python.
Как писать промпты для изображений
Image-модели понимают свободные описания, но предсказуемость результата сильно растёт, если соблюдать несколько правил:
- Описывайте кадр, а не идею. Вместо «красивый город будущего» — «ночной город с высоты птичьего полёта, неоновые вывески, мокрый асфальт отражает огни».
- Называйте стиль и технику. «Фотореализм», «плоская векторная иллюстрация», «акварель», «3D-рендер» — без указания стиля модель выберет его сама.
- Задавайте свет и палитру. «Мягкий закатный свет», «холодные синие тона», конкретные цвета — свет влияет на результат сильнее большинства других слов.
- Перечисляйте ограничения. «Без текста и надписей», «без людей», «без логотипов» — иначе модель может добавить лишнее.
- Фиксируйте стиль для серии. Если картинки нужны в едином оформлении, держите неизменный стилевой «хвост» промпта и меняйте только описание сцены.
- Соотношение сторон задавайте параметром.
image_config: {"aspect_ratio": "16:9"}надёжнее, чем просьба в тексте промпта.
Если первый результат не подошёл, Nano Banana Pro и GPT Image 2 умеют редактировать изображение по текстовой инструкции: исходную картинку можно передать в запросе вместе с описанием правок, а в GPT Image 2 при этом не нужно вручную выделять маски. Для сложных сцен обе модели принимают до 14 референсных изображений.
Сколько стоит генерация изображения
Правило простое: вы платите за токены запроса. Текст промпта и входные изображения считаются по цене входа, а сгенерированные изображения — по отдельному тарифу на изображение на выходе. Списывается с рублёвого баланса после успешного ответа; если модель вернула несколько картинок, оплачиваются все. Тарифы на изображение на выходе по каталогу на ноябрь 2026 года:
| Модель | Изображение на выходе, ₽ за 1 млн токенов |
|---|---|
Nano Banana (google/gemini-2.5-flash-image) | 3 787,09 |
Nano Banana 2 (google/gemini-3.1-flash-image) | 7 574,19 |
Nano Banana Pro (google/gemini-3-pro-image) | 15 148,37 |
GPT-5 Image Mini (openai/gpt-5-image-mini) | 1 009,89 |
GPT Image 2 (openai/gpt-image-2) | 3 787,09 |
GPT-5 Image (openai/gpt-5-image) | 5 049,46 |
Одна картинка расходует лишь часть миллиона токенов, поэтому итог за конкретную генерацию зависит от модели, разрешения и параметров запроса. Точная сумма видна в разделе «Использование» личного кабинета сразу после генерации, а текущие тарифы каждой модели опубликованы на её карточке в каталоге.
Частые вопросы
Можно ли получить несколько изображений за один запрос?
Да, если модель это поддерживает. Например, GPT Image 2 за один запрос возвращает серию до восьми согласованных изображений. Массив images в ответе может содержать несколько элементов, и цикл из примера на Python сохранит каждый в отдельный файл. Помните, что оплата начисляется за каждое изображение в ответе.
Заработает ли официальная библиотека OpenAI?
Да. Меняются только base_url на https://api.hubris.pw/v1 и ключ. Поле modalities не объявлено в типах библиотеки, поэтому в Python его передают через extra_body, а в TypeScript — приведением типа. Сам ответ разбирается стандартными средствами.
Как задать соотношение сторон и размер картинки?
Параметром image_config: поле aspect_ratio принимает значения вроде 1:1, 16:9, 9:16, 4:3, поле image_size — 0.5K, 1K, 2K или 4K. Конкретный набор зависит от модели и указан на её карточке в каталоге. Это надёжнее, чем описывать формат словами в промпте.
Есть ли подписка или минимальный платёж?
Подписки нет. Баланс пополняется по СБП, банковской картой или по счёту для юридических лиц и расходуется только на фактические запросы. История списаний по каждой генерации доступна в личном кабинете.
Все модели из статьи доступны в Hubris — единый API, оплата в рублях.
