GPT Image 2
ID модели: gpt-image-2.
Ответ приходит сразу в data[] (b64_json и/или url).
Оплата
За каждое изображение в ответе (n: 3 — три списания). Тариф зависит от разрешения (1K / 2K / 4K) и quality. Неудачные запросы не тарифицируются. Суммы — в каталоге.
quality: auto и пропуск поля — medium.
Tier берётся по длинной стороне запрошенного size, не по пикселям кадра в ответе:
| Tier | Правило | Примеры |
|---|---|---|
| 1K | длинная сторона ≤ 1536 | 1024×1024, 1536×1024, 1024×1536 |
| 2K | 1537–2048 | 2048×2048, 2048×1152 |
| 4K | длинная сторона > 2048 | 3840×2160, 2160×3840 |
Генерация
POST /v1/images/generations
| Поле | Обязательно | Значения |
|---|---|---|
model |
да | gpt-image-2 |
prompt |
да | до 32 000 символов |
size |
нет | ШxВ, auto или пропуск. Без явного ШxВ шлюз возьмёт resolution + aspect_ratio (иначе 1024×1024) |
n |
нет | 1–10, по умолчанию 1 |
quality |
нет | low, medium, high, auto |
background |
нет | auto, opaque, transparent (альфа — в PNG) |
output_format |
нет | png, jpeg, webp |
output_compression |
нет | 0–100, только jpeg / webp |
image_input |
нет | 1–16 референсов. Синоним: input_references |
Свой size: стороны кратны 16; длинная ≤ 3840, короткая ≥ 256; aspect 1:3 … 3:1; пикселей 655 360–8 294 400.
resolution и aspect_ratio можно передать вместо size: шлюз переведёт их в ШxВ и наружу уйдёт только он. mask на правке даёт 400. input_fidelity не нужен.
Пример
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": "2048x2048",
"n": 1,
"quality": "medium",
"background": "opaque",
"output_format": "webp",
"output_compression": 90
}'Клиентский таймаут для 2K/4K и quality: high — не меньше 180 с.
Правка изображения
POST /v1/images/edits, multipart/form-data.
| Поле | Обязательно | Значения |
|---|---|---|
image |
да | до 16 файлов |
prompt |
да | что изменить |
size, n, quality, background, output_format, … |
нет | как у генерации |
Маска (mask) не поддерживается: ответ 400. Локальную правку опишите в prompt.
curl https://api.lowrouter.ru/v1/images/edits \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=gpt-image-2" \
-F "prompt=Сделай фон светло-серым, объект на переднем плане не меняй" \
-F "size=2048x2048" \
-F "quality=medium" \
-F "image=@source.png"