GPT Image 2.5

GPT Image 2.5 — серия моделей OpenAI, занявшая первые строчки Image Arena. Два тира: gpt-image-2.5-flare — быстрый, для повседневной генерации, серий и прототипов; gpt-image-2.5-sunburst — тир точности, для аккуратных правок и финальных рекламных изображений. Оба работают с POST /v1/images/generations и POST /v1/images/edits.

Параметры

Поле	Описание
model	openai/gpt-image-2.5-flare или openai/gpt-image-2.5-sunburst (короткие gpt-image-2.5-flare / gpt-image-2.5-sunburst)
prompt	Описание изображения, обязательное; до 20 000 символов — загружайте брифы целиком
n	Сколько картинок, от 1 до 4; каждая тарифицируется отдельно
aspect_ratio	Форматы от 1:3 до 3:1, включая 2:1, 1:2, 3:1, 1:3, 21:9; по умолчанию 1:1
resolution	1k, 2k или 4k; по умолчанию 1k
size	Явный размер WxH (стороны кратны 16, до 3840 по длинной стороне)
background	transparent | opaque | auto — ручка фона этой серии
output_format	png | jpeg | webp; по умолчанию png
quality	У серии нет такой ручки: передача параметра вернёт 400

Прозрачный фон

background: "transparent" вырезает объект без подложки — формат при этом обязан быть png или webp (JPEG не держит альфу), иначе 400. auto отдаёт решение модели по промпту, opaque принудительно заливает фон — полезно, когда промпт тянет к прозрачности, а она не нужна.

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.5-flare",
    "prompt": "Стикер: капибара-астронавт, контурный стиль",
    "aspect_ratio": "1:1",
    "background": "transparent",
    "output_format": "png"
  }'

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

/v1/images/edits принимает до 16 референсов за запрос — собирайте коллажи из товаров, референсов стиля и персонажей:

curl https://api.mixen.ai/v1/images/edits \
  -H "Authorization: Bearer $MIXEN_API_KEY" \
  -F model=openai/gpt-image-2.5-sunburst \
  -F image=@model.png \
  -F image=@jacket.png \
  -F image=@studio-light.png \
  -F prompt="Одень модель в эту куртку, свет как на третьем референсе"

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

Python

import base64

img = client.images.generate(
    model="openai/gpt-image-2.5-sunburst",
    prompt="Финальный кадр рекламной кампании: парфюм на мраморной стойке, "
           "капли воды, боковой свет, фотореализм",
    extra_body={"aspect_ratio": "3:1", "resolution": "4k"},
)
with open("banner.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.5-sunburst",
    "prompt": "Финальный кадр рекламной кампании: парфюм на мраморной стойке, капли воды, боковой свет, фотореализм",
    "aspect_ratio": "3:1",
    "resolution": "4k"
  }'

Цена

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

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

• Два тира под задачу: Flare — скорость и сери, Sunburst — точность правок.
• Прозрачный фон нативно (background + png/webp).
• До 16 референсов в /v1/images/edits; промпт до 20 000 символов.
• Форматы кадра от 1:3 до 3:1, размеры до 4K (3840x2160; выше 2560x1440 — экспериментальные у вендора).
• Ручки quality нет; background/output_format чужим моделям вернут 400.
• Работает только с баланса — в бесплатную квоту не входит.

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