GPT Image 1.5

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

Генерация и правка с маской. Прозрачный фон есть только у этой модели. Оплата — один раз за запрос, сколько бы картинок ни было в n.

Ответ всегда в b64_json, ссылки url нет.

Генерация

POST /v1/images/generations

Поле	Обязательно	Значения
`model`	да	`gpt-image-1.5`
`prompt`	да	до 32 000 символов
`size`	нет	`1024x1024`, `1536x1024`, `1024x1536`, `auto`. Других размеров нет
`n`	нет	целое 1–10. По умолчанию `1`
`quality`	нет	`low`, `medium`, `high`, `auto`. По умолчанию `auto`
`background`	нет	`auto`, `opaque`, `transparent`. Для прозрачности формат только `png` или `webp`
`output_format`	нет	`png`, `jpeg`, `webp`. По умолчанию `png`
`output_compression`	нет	целое 0–100. Только вместе с `jpeg` или `webp`. Для `png` не передавайте
`image_input`	нет	1–16 картинок, если нужно опереться на референс. Синоним: `input_references`
`input_fidelity`	нет	`low` или `high`. Имеет смысл только вместе с `image_input`. `high` сильнее сохраняет лица и мелкие детали

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

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

curl https://api.lowrouter.ru/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "gpt-image-1.5",
  "prompt": "Иконка приложения: белый кот в круглом значке, прозрачный фон",
  "size": "1024x1024",
  "n": 2,
  "quality": "high",
  "background": "transparent",
  "output_format": "png"
}'

Референс и высокая точность

curl https://api.lowrouter.ru/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "gpt-image-1.5",
  "prompt": "Тот же человек в том же пальто, анфас, студийный свет",
  "size": "1024x1536",
  "n": 1,
  "quality": "high",
  "background": "opaque",
  "output_format": "webp",
  "output_compression": 80,
  "input_fidelity": "high",
  "image_input": ["https://example.com/portrait.png"]
}'

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

POST /v1/images/edits, тело multipart/form-data.

Поле	Обязательно	Значения
`model`	да	`gpt-image-1.5`
`prompt`	да	что изменить
`image`	да	файл PNG/JPEG/WebP. Несколько файлов — повторите поле `image` или `image[]`, до 16
`mask`	нет	PNG того же размера, что `image`. Прозрачные пиксели — зона правки
`size`, `n`, `quality`, `background`, `output_format`, `output_compression`, `input_fidelity`	нет	те же значения, что у генерации

curl https://api.lowrouter.ru/v1/images/edits \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=gpt-image-1.5" \
-F "prompt=Замени кружку на стеклянный графин, остальное не трогай" \
-F "n=1" \
-F "size=1024x1024" \
-F "quality=high" \
-F "background=opaque" \
-F "output_format=png" \
-F "input_fidelity=high" \
-F "image=@source.png" \
-F "mask=@mask.png"