Введение
GPT Image 2.5 Sunburst Редактирование изображения применяет gpt-image-2.5-sunburst от OpenAI к уже имеющимся изображениям. Модель принимает от одного до шестнадцати исходников, необязательную PNG-маску и опцию прозрачного фона; OpenAI рекомендует её, когда важнее всего точность правок.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| письменный бриф | GPT Image 2.5 Sunburst Текст в изображение |
| изображение, которое нужно изменить | GPT Image 2.5 Sunburst Редактирование изображения |
Ключевые возможности и особенности
Маски, точность и прозрачность
Маска ограничивает перерисовку своими прозрачными пикселями; input_fidelity high держит лица и ткани ближе к исходникам; 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 / изображение |
Сценарии использования
Ретушь утверждённых фото
Смените одежду, цвет или свет на утверждённом фото, не трогая остальное изображение, с маской или без неё.
Вырезанные объекты для макетов
Люди и продукты на прозрачном фоне, готовые для макета, слайда или страницы товара без отдельного шага удаления фона.
Цветовые варианты продукта
Одно фото продукта в нескольких отделках или цветах, с маской на продукте, чтобы декорации и свет оставались идентичными.
Руководство по промптам и практические советы
Стройте маску по исходнику
Тот же размер в пикселях, что и у первого исходника, сохранён в PNG, прозрачен только там, где нужна перерисовка. Всё непрозрачное защищено.
Выписывайте список защищённого
После изменения перечислите, что должно остаться: лицо, волосы, поза, стул, свет. Модель надёжнее следует написанному списку, чем подразумеваемому.
Для вырезки пишите, что остаётся
Назовите объект, который остаётся, и то, что фон должен быть полностью прозрачным, и задайте output_format = png или webp.
Проверьте альфа-канал до вёрстки
Откройте полученный PNG или WebP в программе вёрстки: пустая область — настоящий альфа-канал, так что дополнительный кеинг или маскирование не нужны.
Быстрый старт 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-sunburst/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.





