GPT Image 2
model-gpt-image-2POST/v1/generationsОриентирот 7 кредитовПопробовать
#Для оценки отправьте то же тело в POST /v1/generations/estimate без Idempotency-Key — ответ покажет costCents и блок billing с кошельком списания. Чтобы сохранить результат в папку, добавьте projectId.
Параметры
#promptstringобязательныйЧто хотите создать? — Опишите изображение или желаемые изменения.
- По умолчанию
- нет
- Ограничения
- до 32000 символов
image_urlsfile[] · inputAssetsнеобязательныйРеференсы (необязательно) — Добавьте до 16 изображений, чтобы изменить их или сохранить стиль и композицию.
- По умолчанию
- нет
- Ограничения
- до 16 файлов · форматы: image/*
image_sizestring (размер)необязательныйРазмер изображения — Выберите размер и соотношение сторон готового изображения.
- По умолчанию
"1024x768"
Допустимые значения
autoAUTO1024x10241024 × 1024 (1:1) · квадрат1024x7681024 × 768 (4:3) · альбом1536x10241536 × 1024 (3:2) · альбом1920x10801920 × 1080 (16:9) · Full HD2560x14402560 × 1440 (16:9) · 2K3840x21603840 × 2160 (16:9) · 4K3392x24003392 × 2400 (297:210) · A4 альбом768x1024768 × 1024 (3:4) · портрет1024x15361024 × 1536 (2:3) · портрет1080x19201080 × 1920 (9:16) · Full HD1440x25601440 × 2560 (9:16) · 2K2160x38402160 × 3840 (9:16) · 4K2400x33922400 × 3392 (210:297) · A4 портрет2048x20481:1 · 2K4096x40961:1 · 4K2048x15364:3 · 2K4096x30724:3 · 4K1536x20483:4 · 2K3072x40963:4 · 4K1024x57616:9 · 1K2048x115216:9 · 2K4096x230416:9 · 4K576x10249:16 · 1K1152x20489:16 · 2K2304x40969:16 · 4K680x10242:3 · 1K1368x20482:3 · 2K2728x40962:3 · 4K1024x6803:2 · 1K2048x13683:2 · 2K4096x27283:2 · 4K1024x44021:9 · 1K2048x88021:9 · 2K4096x175221:9 · 4K816x10244:5 · 1K1640x20484:5 · 2K3280x40964:5 · 4K1024x8165:4 · 1K2048x16405:4 · 2K4096x32805:4 · 4K
image_resolutionstring (enum)необязательныйРазрешение при AUTO — Определяет детализацию, когда точные размеры выбирает модель.
- По умолчанию
"1K"- Ограничения
- активно, когда image_size = "auto"
Допустимые значения
1K2K4K
qualitystring (enum)необязательныйКачество
- По умолчанию
"medium"
Допустимые значения
lowБыстроеmediumСреднееhighВысокое
num_imagesnumberнеобязательныйКоличество вариантов
- По умолчанию
1- Ограничения
- 1–4
output_formatstring (enum)необязательный· расширенныйФормат файла
- По умолчанию
"png"
Допустимые значения
pngjpegwebp
mask_urlfile · inputAssetsнеобязательный· расширенныйМаска редактирования — Необязательно. Укажите область изменений; работает вместе с референсом.
- По умолчанию
- нет
- Ограничения
- форматы: image/* · требует image_urls
number и boolean — настоящие JSON-числа и логические значения, dimensions — строка из допустимых вариантов, json — JSON-значение или строка с JSON. «Обязательный» относится к активному сценарию: поля других сценариев и поля с невыполненным условием «активно, когда» не проверяются.
Сценарии
#scenario-0передан файл image_urls
Активные поля: prompt, image_urls, image_size, image_resolution, quality, num_images, output_format, mask_url
{
"model": "model-gpt-image-2",
"values": {
"prompt": "Describe the desired result",
"image_size": "1024x768",
"quality": "medium",
"num_images": 1,
"output_format": "png"
},
"inputAssets": [
{
"fieldName": "image_urls",
"assetId": "REPLACE_WITH_READY_ASSET_ID",
"position": 0
}
]
}scenario-1по умолчанию
Активные поля: prompt, image_urls, image_size, image_resolution, quality, num_images, output_format, mask_url
{
"model": "model-gpt-image-2",
"values": {
"prompt": "Describe the desired result",
"image_size": "1024x768",
"quality": "medium",
"num_images": 1,
"output_format": "png"
},
"inputAssets": []
}Цена и результат
#Ориентир при стандартных настройках — 7 кредитов; точная цена зависит от параметров и кошелька, поэтому проверяйте её через estimate. Запуск возвращает HTTP 202, дальше опрашивайте GET /v1/generations/:id раз в 3–5 секунд до completed или failed.
Готовые файлы — в assets[] (url, downloadUrl, mediaAssetId), текст — в textOutput, 3D — в viewerUrl/modelUrl, а выбор форматов скачивания (GLB, FBX, OBJ) — в modelFormats[]. Ответ также содержит prompt, reuseValues, projectId, billingMode и usageUsdMicros. Подробнее — в разделах Запуск и статус и Ошибки и лимиты.
Машиночитаемая схема: GET /v1/generation-models/model-gpt-image-2. Схема обновляется вместе с каталогом; выключенная модель возвращает 404.