GPT Image 2

ID модели: gpt-image-2.

Генерация и правка с маской, свой размер вплоть до 4K. Прозрачного фона нет. Оплата — один раз за запрос.

Ответ всегда в b64_json.

Поле input_fidelity не передавайте: входные картинки и так обрабатываются в высокой детализации.

Генерация

POST /v1/images/generations

Поле	Обязательно	Значения
`model`	да	`gpt-image-2`
`prompt`	да	до 32 000 символов
`size`	нет	`auto`, `1024x1024`, `1536x1024`, `1024x1536` или свой `ШxВ`
`n`	нет	целое 1–10. По умолчанию `1`
`quality`	нет	`low`, `medium`, `high`, `auto`. По умолчанию `auto`
`background`	нет	`auto` или `opaque`. Значение `transparent` вернёт ошибку
`output_format`	нет	`png`, `jpeg`, `webp`. По умолчанию `png`
`output_compression`	нет	целое 0–100, только для `jpeg` и `webp`
`image_input`	нет	1–16 картинок. Синоним: `input_references`

Свой size:

обе стороны кратны 16;
длинная сторона не больше 3840, короткая не меньше 256;
отношение сторон от 1:3 до 3:1;
пикселей от 655 360 до 8 294 400.

Размер больше 2560x1440 (около 3.7 млн пикселей) — экспериментальный: картинка может быть менее стабильной.

Не передавайте: resolution, aspect_ratio, input_fidelity, style, background: transparent.

Пример со всеми полями

curl https://api.lowrouter.ru/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "gpt-image-2",
  "prompt": "Постер с крупным читаемым заголовком OPEN DAY, белый фон, чёрный гротеск",
  "size": "2560x1440",
  "n": 1,
  "quality": "high",
  "background": "opaque",
  "output_format": "webp",
  "output_compression": 90,
  "image_input": ["https://example.com/layout-ref.png"]
}'

Правка с маской

POST /v1/images/edits, multipart/form-data. Поля те же, что у генерации, плюс файлы.

Поле	Обязательно	Значения
`image`	да	до 16 файлов, поля `image` или `image[]`
`mask`	нет	PNG того же размера, что первое изображение. Прозрачные пиксели — зона правки

curl https://api.lowrouter.ru/v1/images/edits \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=gpt-image-2" \
-F "prompt=Расширь фон влево, сохрани человека без изменений" \
-F "n=1" \
-F "size=2048x1152" \
-F "quality=high" \
-F "background=opaque" \
-F "output_format=png" \
-F "image=@source.png" \
-F "mask=@mask.png"