Введение
GPT Image 2.5 Flare Редактирование изображения применяет gpt-image-2.5-flare от OpenAI к уже имеющимся изображениям. Модель принимает от одного до шестнадцати исходников, PNG-маску и опцию прозрачного фона и возвращает правки достаточно быстро для интерактивной работы.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| письменный бриф | GPT Image 2.5 Flare Текст в изображение |
| изображение, которое нужно изменить | GPT Image 2.5 Flare Редактирование изображения |
Ключевые возможности и особенности
Быстрые композиции из нескольких исходников
Два и более исходника становятся одной сценой, лица сохраняются из своих изображений. Наш пример с двумя исходниками завершился гораздо быстрее минуты.
Маски и вырезка
PNG-маска ограничивает перерисовку одной областью; background = transparent возвращает настоящий альфа-канал в PNG или WebP, готовый для макета без кеинга.
Несколько изменений за проход
Наряд, время суток и погода могут меняться вместе, если промпт говорит и о том, что остаётся прежним. В нашем примере с террасой платье и свет сменились за один запрос.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Каждое слово, которое должно появиться на изображении, возьмите в двойные кавычки и укажите, где оно стоит; остальное читается как описание. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От 1 до 16 исходных изображений. В промпте ссылайтесь на них по порядку (первое изображение, второе изображение). Не менее 1 элементов · Не более 16 элементов |
mask_url | Нет | Необязательный PNG того же размера, что и первое исходное изображение. Прозрачные пиксели отмечают область для перерисовки, непрозрачные остаются как есть. |
aspect_ratio | Нет | Пятнадцать соотношений сторон от 1:3 до 3:1, по умолчанию 1:1. Результат получает выбранное соотношение, а не соотношение исходника, и соотношение влияет на цену. |
resolution | Нет | 1k (по умолчанию), 2k или 4k. Квадратное изображение имеет сторону 1024, 2048 или 2880 пикселей; более высокий уровень стоит дороже за изображение. |
quality | Нет | low, medium, high (по умолчанию), xhigh или max. Каждый уровень добавляет деталей, времени и стоимости; оставьте xhigh и max для финальных версий. |
num_outputs | Нет | От 1 до 10 изображений за запрос, по умолчанию 1. Каждое изображение оплачивается отдельно. |
input_fidelity | Нет | low (по умолчанию) или high. High точнее сохраняет лица, ткани и напечатанные детали исходников. |
background | Нет | auto (по умолчанию), transparent или opaque. Для transparent нужен вывод в png или webp, и возвращается настоящий альфа-канал. |
output_format | Нет | png (по умолчанию), jpeg или webp. На цену не влияет. |
output_quality | Нет | Качество сжатия для jpeg и webp, от 0 до 100: чем выше значение, тем больше деталей и тем больше файл. Для png не используется и на цену не влияет. |
official_fallback | Нет | По умолчанию включено. По умолчанию: |
Стоимость
Оплата за каждое выходное изображение по качеству, уровню размера и соотношению сторон; на официальном маршруте каждое исходное изображение добавляет ещё фиксированную сумму за каждое выходное. Расчёт стоимости показывает итог до отправки. Запрос на одну правку с выводом PNG в качестве high и размере 1k в соотношении 1:1, 3:2, 2:3, 4:3, 3:4, 16:9 или 9:16, без маски, с input fidelity low и background auto начинается на экономичном маршруте по экономичной цене. Если включён Official fallback (по умолчанию включён), запрос, который этот маршрут отклонил или не смог выполнить, запускается заново на официальном маршруте по официальной цене, поэтому расчёт стоимости показывает стартовую цену и максимум. Отклонённые запросы не оплачиваются. На официальном маршруте длинные промпты добавляют небольшую доплату за входные токены сверх первых 100, один раз за запрос; текст на китайском, японском и корейском считается примерно как один токен на символ.
| Спецификация | Стоимость |
|---|---|
| $0.001816 / изображение |
| $0.001816 / изображение |
| $0.00244 / изображение |
| $0.00244 / изображение |
| $0.002752 / изображение |
| $0.002752 / изображение |
| $0.00304 / изображение |
| $0.00304 / изображение |
| $0.003568 / изображение |
| $0.003568 / изображение |
| $0.003808 / изображение |
| $0.003808 / изображение |
| $0.003856 / изображение |
| $0.003856 / изображение |
| $0.004192 / изображение |
| $0.004192 / изображение |
| $0.004744 / изображение |
| $0.004744 / изображение |
| $0.005104 / изображение |
| $0.00568 / изображение |
| $0.00568 / изображение |
| $0.00652 / изображение |
| $0.00652 / изображение |
| $0.007312 / изображение |
| $0.007312 / изображение |
| $0.008176 / изображение |
| $0.008176 / изображение |
| $0.008728 / изображение |
| $0.008728 / изображение |
| $0.010936 / изображение |
| $0.01396 / изображение |
| $0.01396 / изображение |
| $0.018592 / изображение |
| $0.018592 / изображение |
| $0.020998 / изображение (С Official fallback: до $0.023992) |
| $0.020998 / изображение (С Official fallback: до $0.023992) |
| $0.021472 / изображение |
| $0.021472 / изображение |
| $0.022 / изображение (С Official fallback: до $0.028) |
| $0.022 / изображение (С Official fallback: до $0.028) |
| $0.022864 / изображение (С Official fallback: до $0.031456) |
| $0.022864 / изображение (С Official fallback: до $0.031456) |
| $0.024136 / изображение |
| $0.024136 / изображение |
| $0.025636 / изображение (С Official fallback: до $0.042544) |
| $0.0316 / изображение |
| $0.0316 / изображение |
| $0.034504 / изображение |
| $0.034504 / изображение |
| $0.037864 / изображение |
| $0.037864 / изображение |
| $0.043504 / изображение |
| $0.043504 / изображение |
| $0.049816 / изображение |
| $0.049816 / изображение |
| $0.054616 / изображение |
| $0.054616 / изображение |
| $0.055624 / изображение |
| $0.055624 / изображение |
| $0.059872 / изображение |
| $0.059872 / изображение |
| $0.07144 / изображение |
| $0.07144 / изображение |
| $0.075328 / изображение |
| $0.082936 / изображение |
| $0.082936 / изображение |
| $0.096472 / изображение |
| $0.096472 / изображение |
| $0.110728 / изображение |
| $0.110728 / изображение |
| $0.124624 / изображение |
| $0.124624 / изображение |
| $0.135064 / изображение |
| $0.135064 / изображение |
| $0.168976 / изображение |
| $0.002872 / изображение |
| $0.002872 / изображение |
| $0.004456 / изображение |
| $0.004456 / изображение |
| $0.005152 / изображение |
| $0.005152 / изображение |
| $0.005704 / изображение |
| $0.005704 / изображение |
| $0.006328 / изображение |
| $0.006328 / изображение |
| $0.006712 / изображение |
| $0.006712 / изображение |
| $0.007312 / изображение |
| $0.007312 / изображение |
| $0.008128 / изображение |
| $0.008128 / изображение |
| $0.009088 / изображение |
| $0.009088 / изображение |
| $0.009928 / изображение |
| $0.01108 / изображение |
| $0.01108 / изображение |
| $0.01276 / изображение |
| $0.01276 / изображение |
| $0.014176 / изображение |
| $0.014176 / изображение |
| $0.015904 / изображение |
| $0.015904 / изображение |
| $0.017296 / изображение |
| $0.017296 / изображение |
| $0.021808 / изображение |
| $0.024112 / изображение |
| $0.024112 / изображение |
| $0.03688 / изображение |
| $0.03688 / изображение |
| $0.041896 / изображение |
| $0.041896 / изображение |
| $0.043072 / изображение |
| $0.043072 / изображение |
| $0.048064 / изображение |
| $0.048064 / изображение |
| $0.055432 / изображение |
| $0.055432 / изображение |
| $0.062416 / изображение |
| $0.062416 / изображение |
| $0.062944 / изображение |
| $0.062944 / изображение |
| $0.067984 / изображение |
| $0.067984 / изображение |
| $0.07624 / изображение |
| $0.07624 / изображение |
| $0.086032 / изображение |
| $0.087496 / изображение |
| $0.087496 / изображение |
| $0.095248 / изображение |
| $0.095248 / изображение |
| $0.098968 / изображение |
| $0.098968 / изображение |
| $0.110656 / изображение |
| $0.110656 / изображение |
| $0.121312 / изображение |
| $0.121312 / изображение |
| $0.142816 / изображение |
| $0.142816 / изображение |
| $0.152632 / изображение |
| $0.171016 / изображение |
| $0.171016 / изображение |
| $0.19456 / изображение |
| $0.19456 / изображение |
| $0.220456 / изображение |
| $0.220456 / изображение |
| $0.248464 / изображение |
| $0.248464 / изображение |
| $0.274216 / изображение |
| $0.274216 / изображение |
| $0.342928 / изображение |
| $0.003736 / изображение |
| $0.003736 / изображение |
| $0.006016 / изображение |
| $0.006016 / изображение |
| $0.0076 / изображение |
| $0.0076 / изображение |
| $0.008368 / изображение |
| $0.008368 / изображение |
| $0.009304 / изображение |
| $0.009304 / изображение |
| $0.011176 / изображение |
| $0.011176 / изображение |
| $0.01192 / изображение |
| $0.01192 / изображение |
| $0.0124 / изображение |
| $0.0124 / изображение |
| $0.01324 / изображение |
| $0.01324 / изображение |
| $0.016216 / изображение |
| $0.0166 / изображение |
| $0.0166 / изображение |
| $0.02116 / изображение |
| $0.02116 / изображение |
| $0.023872 / изображение |
| $0.023872 / изображение |
| $0.026296 / изображение |
| $0.026296 / изображение |
| $0.028552 / изображение |
| $0.028552 / изображение |
| $0.032272 / изображение |
| $0.032272 / изображение |
| $0.035992 / изображение |
| $0.050776 / изображение |
| $0.050776 / изображение |
| $0.056176 / изображение |
| $0.056176 / изображение |
| $0.0652 / изображение |
| $0.0652 / изображение |
| $0.080464 / изображение |
| $0.080464 / изображение |
| $0.086752 / изображение |
| $0.086752 / изображение |
| $0.094288 / изображение |
| $0.094288 / изображение |
| $0.103984 / изображение |
| $0.103984 / изображение |
| $0.11296 / изображение |
| $0.11296 / изображение |
| $0.115576 / изображение |
| $0.115576 / изображение |
| $0.127864 / изображение |
| $0.127864 / изображение |
| $0.14272 / изображение |
| $0.14272 / изображение |
| $0.14272 / изображение |
| $0.168592 / изображение |
| $0.168592 / изображение |
| $0.184552 / изображение |
| $0.184552 / изображение |
| $0.197104 / изображение |
| $0.197104 / изображение |
| $0.201832 / изображение |
| $0.201832 / изображение |
| $0.253408 / изображение |
| $0.259552 / изображение |
| $0.259552 / изображение |
| $0.320608 / изображение |
| $0.320608 / изображение |
| $0.37588 / изображение |
| $0.37588 / изображение |
| $0.414736 / изображение |
| $0.414736 / изображение |
| $0.456544 / изображение |
| $0.456544 / изображение |
| $0.569656 / изображение |
Сценарии использования
Примерка нарядов и смена стиля
Покажите того же человека в новом наряде или в новом месте для лукбука или черновика кампании, с несколькими вариантами за запрос.
Объединение людей с разных снимков
Поместите в одно изображение двух людей, снятых отдельно, для постера, миниатюры или кадра сторис.
Сезонные обновления
Превратите изображение летней кампании в осеннюю или ночную версию для следующего сезона, не меняя человека и продукт.
Руководство по промптам и практические советы
Дайте каждому исходнику задачу
Мужчина и дверной проём — с первого изображения, женщина — со второго: напишите это, потому что порядок — единственная связь между промптом и исходниками.
Группируйте связанные изменения
Новый наряд и другое время суток хорошо укладываются в один запрос; не связанные между собой изменения лучше делать отдельными правками.
Повышайте точность для лиц
Задайте input_fidelity = high, когда лицо должно остаться узнаваемым после правки; цена не меняется.
Маска для замены фона
Когда меняется только фон, оставьте объект непрозрачным, а фон прозрачным в PNG-маске размером с первый исходник.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "openai/gpt-image-2.5-flare/edit",
"input": {
"aspect_ratio": "1:1",
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"input_fidelity": "low",
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.





