Введение
GPT Image 2 Редактирование изображения применяет модель gpt-image-2 от OpenAI к уже имеющимся изображениям. Дайте ей от одного до десяти исходников и указание: смените одежду или цвет, перепишите заголовок, измените свет в сцене или объедините людей и места из нескольких исходников в одно изображение. Необязательная PNG-маска ограничивает перерисовку одной областью.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| письменный бриф | GPT Image 2 Текст в изображение |
| изображение, которое нужно изменить | GPT Image 2 Редактирование изображения |
Ключевые возможности и особенности
Правки по указанию, при необходимости с маской
Без маски модель сама выводит из промпта, что менять, и согласованно дорисовывает остальное. С маской перерисовываются только прозрачные пиксели, всё остальное остаётся.
До десяти исходников за запрос
Ссылайтесь на каждый исходник по порядку: первое изображение даёт человека, второе — обстановку, третье — продукт. Модель собирает их в новое изображение.
Контроль точности и формы
Input_fidelity high держит лица, ткани и напечатанные детали ближе к исходникам. Соотношение auto сохраняет форму первого исходника; любое из пятнадцати фиксированных соотношений придаёт результату эту форму.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Каждое слово, которое должно появиться на изображении, возьмите в двойные кавычки и укажите, где оно стоит; остальное читается как описание. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От 1 до 10 исходных изображений. В промпте ссылайтесь на них по порядку (первое изображение, второе изображение). Не менее 1 элементов · Не более 10 элементов |
mask_url | Нет | Необязательный PNG того же размера, что и первое исходное изображение. Прозрачные пиксели отмечают область для перерисовки, непрозрачные остаются как есть. |
aspect_ratio | Нет | auto (по умолчанию) сохраняет форму первого исходного изображения примерно при 1,5 мегапикселя и игнорирует уровень размера; либо выберите одно из пятнадцати соотношений от 1:3… |
resolution | Нет | 1k (по умолчанию), 2k или 4k. Квадратное изображение имеет сторону 1024, 2048 или 2880 пикселей; более высокий уровень стоит дороже за изображение. |
quality | Нет | low, medium (по умолчанию) или high. |
num_outputs | Нет | От 1 до 10 изображений за запрос, по умолчанию 1. Каждое изображение оплачивается отдельно. |
input_fidelity | Нет | low (по умолчанию) или high. High точнее сохраняет лица, ткани и напечатанные детали исходников. |
background | Нет | auto (по умолчанию) или opaque. OpenAI не предлагает прозрачный вывод в GPT Image 2; для вырезанных объектов используйте GPT Image 2.5 Sunburst или Flare. |
output_format | Нет | png (по умолчанию), jpeg или webp. На цену не влияет. |
output_quality | Нет | Качество сжатия для jpeg и webp, от 0 до 100: чем выше значение, тем больше деталей и тем больше файл. Для png не используется и на цену не влияет. |
official_fallback | Нет | По умолчанию включено. По умолчанию: |
Стоимость
Оплата за каждое выходное изображение по качеству, уровню размера и соотношению сторон; на официальном маршруте каждое исходное изображение добавляет ещё фиксированную сумму за каждое выходное. Расчёт стоимости показывает итог до отправки. Запрос на одну правку с выводом PNG в качестве medium и размере 1k в любом соотношении сторон, кроме 21:9, 9:21, 3:1 и 1:3, без маски, с input fidelity low и background auto начинается на экономичном маршруте по экономичной цене. Если включён Official fallback (по умолчанию включён), запрос, который этот маршрут отклонил или не смог выполнить, запускается заново на официальном маршруте по официальной цене, поэтому расчёт стоимости показывает стартовую цену и максимум. Отклонённые запросы не оплачиваются. На официальном маршруте длинные промпты добавляют небольшую доплату за входные токены сверх первых 100, один раз за запрос; текст на китайском, японском и корейском считается примерно как один токен на символ.
| Спецификация | Стоимость |
|---|---|
| $0.001816 / изображение |
| $0.001816 / изображение |
| $0.00244 / изображение |
| $0.00244 / изображение |
| $0.002752 / изображение |
| $0.002752 / изображение |
| $0.002872 / изображение |
| $0.002872 / изображение |
| $0.00304 / изображение |
| $0.00304 / изображение |
| $0.003568 / изображение |
| $0.003568 / изображение |
| $0.003736 / изображение |
| $0.003736 / изображение |
| $0.003856 / изображение |
| $0.003856 / изображение |
| $0.004192 / изображение |
| $0.004192 / изображение |
| $0.004456 / изображение |
| $0.004456 / изображение |
| $0.005104 / изображение |
| $0.005152 / изображение |
| $0.005152 / изображение |
| $0.005704 / изображение |
| $0.005704 / изображение |
| $0.005896 / изображение |
| $0.006016 / изображение |
| $0.006016 / изображение |
| $0.006712 / изображение |
| $0.006712 / изображение |
| $0.007312 / изображение |
| $0.007312 / изображение |
| $0.0076 / изображение |
| $0.0076 / изображение |
| $0.008128 / изображение |
| $0.008128 / изображение |
| $0.009304 / изображение |
| $0.009304 / изображение |
| $0.009928 / изображение |
| $0.009928 / изображение |
| $0.011176 / изображение |
| $0.011176 / изображение |
| $0.01192 / изображение |
| $0.01192 / изображение |
| $0.01324 / изображение |
| $0.01324 / изображение |
| $0.016216 / изображение |
| $0.016216 / изображение |
| $0.01396 / изображение |
| $0.01396 / изображение |
| $0.018592 / изображение |
| $0.018592 / изображение |
| $0.020368 / изображение (С Official fallback: до $0.021472) |
| $0.020368 / изображение (С Official fallback: до $0.021472) |
| $0.020998 / изображение (С Official fallback: до $0.023992) |
| $0.020998 / изображение (С Official fallback: до $0.023992) |
| $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.023626 / изображение (С Official fallback: до $0.034504) |
| $0.023626 / изображение (С Official fallback: до $0.034504) |
| $0.024112 / изображение |
| $0.024112 / изображение |
| $0.025636 / изображение (С Official fallback: до $0.042544) |
| $0.027448 / изображение (С Official fallback: до $0.049792) |
| $0.032272 / изображение |
| $0.032272 / изображение |
| $0.03688 / изображение |
| $0.03688 / изображение |
| $0.043072 / изображение |
| $0.043072 / изображение |
| $0.048064 / изображение |
| $0.048064 / изображение |
| $0.050776 / изображение |
| $0.050776 / изображение |
| $0.055432 / изображение |
| $0.055432 / изображение |
| $0.062416 / изображение |
| $0.062416 / изображение |
| $0.0652 / изображение |
| $0.0652 / изображение |
| $0.067984 / изображение |
| $0.067984 / изображение |
| $0.080464 / изображение |
| $0.080464 / изображение |
| $0.086032 / изображение |
| $0.086032 / изображение |
| $0.094288 / изображение |
| $0.094288 / изображение |
| $0.103984 / изображение |
| $0.103984 / изображение |
| $0.11296 / изображение |
| $0.11296 / изображение |
| $0.14272 / изображение |
| $0.14272 / изображение |
| $0.054616 / изображение |
| $0.054616 / изображение |
| $0.07144 / изображение |
| $0.07144 / изображение |
| $0.082936 / изображение |
| $0.082936 / изображение |
| $0.095248 / изображение |
| $0.095248 / изображение |
| $0.096472 / изображение |
| $0.096472 / изображение |
| $0.110728 / изображение |
| $0.110728 / изображение |
| $0.124624 / изображение |
| $0.124624 / изображение |
| $0.127864 / изображение |
| $0.127864 / изображение |
| $0.135064 / изображение |
| $0.135064 / изображение |
| $0.142816 / изображение |
| $0.142816 / изображение |
| $0.168976 / изображение |
| $0.171016 / изображение |
| $0.171016 / изображение |
| $0.19456 / изображение |
| $0.19456 / изображение |
| $0.197104 / изображение |
| $0.197104 / изображение |
| $0.197968 / изображение |
| $0.220456 / изображение |
| $0.220456 / изображение |
| $0.248464 / изображение |
| $0.248464 / изображение |
| $0.259552 / изображение |
| $0.259552 / изображение |
| $0.274216 / изображение |
| $0.274216 / изображение |
| $0.320608 / изображение |
| $0.320608 / изображение |
| $0.342928 / изображение |
| $0.342928 / изображение |
| $0.37588 / изображение |
| $0.37588 / изображение |
| $0.414736 / изображение |
| $0.414736 / изображение |
| $0.456544 / изображение |
| $0.456544 / изображение |
| $0.569656 / изображение |
| $0.569656 / изображение |
Сценарии использования
Смена текста и стиля в готовых материалах
Замените слова на постере или обложке, цвет продукта или предмет одежды, а фото под ними оставьте ровно таким, каким его утвердили.
Сборка сцен из референсов
Поместите человека с одного фото в обстановку с другого или сведите вместе двух людей, снятых отдельно, не восстанавливая макет по текстовому промпту.
Локальные версии одного визуала
Сохраните фото и замените заголовок переведённой строкой для каждого рынка — одна правка на язык.
Руководство по промптам и практические советы
Пишите, что остаётся, а не только что меняется
Сначала изменение, затем то, что не должно сдвинуться: лицо, поза, свет, фон, логотип. Всё, что вы не защитили, может быть перерисовано.
Нумеруйте исходники
Пишите «женщина с первого изображения» и «лодка со второго изображения». Порядок в image_urls — единственная привязка, которая есть у модели.
Маска для мелких правок
Для одного объекта или куска фона PNG-маска размером с первый исходник надёжнее словесного описания.
Оставляйте auto, чтобы сохранить кадр
Оставьте соотношение auto, когда правка должна сохранить кадр исходника; фиксированное соотношение выбирайте, только если результату нужна новая форма.
Быстрый старт 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/edit",
"input": {
"aspect_ratio": "auto",
"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.





