GPT Image 2

GPT Image 2 (openai/gpt-image-2) — модель генерации картинок от OpenAI. Работает с двумя эндпоинтами: POST /v1/images/generations для генерации по тексту и POST /v1/images/edits для работы по картинке-образцу. Модель платная — генерации списываются с баланса.

Параметры

Поле	Описание
model	openai/gpt-image-2 (или короткое gpt-image-2)
prompt	Описание изображения, обязательное; до 32 000 символов
n	Сколько картинок, от 1 до 4; каждая тарифицируется отдельно
aspect_ratio	1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9; по умолчанию 1:1
resolution	1k, 2k или 4k; по умолчанию 1k
size	Явный размер WxH из фиксированной таблицы модели
quality	У модели нет такой ручки: передача параметра вернёт 400

Размеры у GPT Image 2 не вычисляются из формата — они заданы таблицей на каждую пару «разрешение + формат». Ходовые комбинации:

Формат	1k	2k	4k
1:1	1024x1024	2048x2048	2880x2880
16:9	1792x1024	2048x1152	3840x2160
9:16	1024x1792	1152x2048	2160x3840
4:3	1024x1024	2048x1536	3328x2496
21:9	1792x1024	2880x1232	4480x1920

Обратите внимание на колонку 1k: несколько разных форматов дают один и тот же WxH. Поэтому для этой модели надёжнее задавать aspect_ratio + resolution, а size оставить как совместимость — обратное преобразование WxH → формат при коллизии берёт первый подходящий вариант.

Примеры

Генерация по тексту

Python

import base64

img = client.images.generate(
    model="openai/gpt-image-2",
    prompt="Изометрическая иллюстрация книжного кафе, тёплая палитра, детализация",
    extra_body={"aspect_ratio": "16:9", "resolution": "2k"},
)
with open("cafe.png", "wb") as f:
    f.write(base64.b64decode(img.data[0].b64_json))

cURL

curl https://api.mixen.ai/v1/images/generations \
  -H "Authorization: Bearer $MIXEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "Изометрическая иллюстрация книжного кафе, тёплая палитра, детализация",
    "aspect_ratio": "16:9",
    "resolution": "2k"
  }'

Явный размер вместо пары параметров

{
  "model": "openai/gpt-image-2",
  "prompt": "Обложка подкаста про космос: минимализм, глубокий синий, звёздная пыль",
  "size": "2880x1232"
}

Редактирование по образцу

Модель принимает картинки-образцы (references: true), поэтому доступен /v1/images/edits:

curl https://api.mixen.ai/v1/images/edits \
  -H "Authorization: Bearer $MIXEN_API_KEY" \
  -F model=openai/gpt-image-2 \
  -F image=@cat.png \
  -F prompt="Переодень кота в костюм космонавта, фон оставь"

Ответ всегда содержит b64_json. Оба эндпоинта отвечают синхронно — ставьте таймаут HTTP-клиента не меньше 120 секунд.

Цена

4.0108 ₽ ($0.045) за изображение — единая витринная цена из каталога. Актуальные значения — каталог.

Сильные стороны и ограничения

• Двадцать три фиксированных размера в трёх разрешениях — от 1024x1024 до 3840x2160 и 4480x1920.
• Десять форматов кадра, включая панорамный 21:9 для баннеров и обложек.
• Редактирование по образцу через /v1/images/edits — тот же ключ и тот же синтаксис, что у генерации.
• На 1k разные форматы дают одинаковый WxH — задавайте aspect_ratio + resolution, а не size.
• Ручки quality нет; размер вне таблицы модели вернёт 400.
• Работает только с баланса — в бесплатную квоту не входит.

Все модели — в каталоге. Общий порядок работы с изображениями — гайд по изображениям.