Перейти к основному содержанию
POST
Image editing: edit or fuse reference images with locked output size
Интерактивный Playground справа поддерживает прямую загрузку локальных изображений. Введите ваш API Key в поле Authorization (формат: Bearer sk-xxx), выберите изображение, задайте prompt / model / size, затем нажмите «Отправить».
Область применения: эта страница посвящена редактированию или объединению одного или нескольких референсных изображений. В запросе используется multipart/form-data. Для чистой генерации изображений по тексту см. эндпоинт Text-to-Image.Отличие от gpt-image-2-all: идентичная структура вызова, только одно дополнительное поле size. Если вам не требуется фиксировать размеры и нужен максимально быстрый результат, используйте gpt-image-2-all.
🖥️ Ограничение браузерного PlaygroundЭтот эндпоинт по умолчанию возвращает строку base64 (b64_json), размер которой может составлять несколько МБ, поэтому браузерный Playground может отображать 请求时发生错误: unable to complete request — на самом деле запрос выполнен успешно; просто браузер не может отобразить столь длинную строку base64.Рекомендуемый рабочий процесс: если вам требуется base64 или нужно загрузить очень большие референсные изображения, скопируйте приведенный ниже пример кода и запустите его локально.
📎 Порядок объединения нескольких изображений имеет значениеПоле image принимает несколько референсных изображений. Порядок служит основой для ссылок «image1 / image2 / image3» в вашем prompt. Явно ссылайтесь на них в prompt, например:
Поместите человека с image1 в сцену image2 в художественном стиле image3
Рекомендуется ≤ 10 МБ на изображение, форматы png / jpg / webp. Слишком большие изображения могут превысить лимиты шлюза.
🎯 Редактирование с сохранением пропорций: при передаче size=auto (или если опустить size) результат наследует соотношение сторон того референсного изображения, которое указано в prompt как цель редактирования, — не обязательно первого в сценариях с несколькими изображениями.Например, с prompt «измените image2, поменяйте одежду и шляпу у image2 в соответствии с image1», если image2 имеет формат 1:1, то и результат будет 1:1 (даже если image1 — альбомное 16:9).Полезно для смены одежды, добавления аксессуаров, ретуши и других видов редактирования с сохранением формы. Если в prompt цель не указана, модель принимает решение самостоятельно; передавайте явное значение size из 30 вариантов только тогда, когда вам необходимо изменить соотношение сторон.
⚠️ Важные примечания к параметрам
  • size: для редактирования рекомендуется использовать auto (или опустить это поле) — модель сохраняет соотношение сторон того референсного изображения, которое указано в prompt как цель редактирования, а не обязательно первого в сценариях с несколькими изображениями. Например, с prompt «измените image2, поменяйте одежду у image2 в соответствии с image1» соотношение сторон результата будет соответствовать image2; если prompt не устраняет неоднозначность, модель принимает решение самостоятельно. Чтобы принудительно задать другой размер, выберите один из 30 поддерживаемых размеров; используйте строчный ASCII x, например, 2048x1360, 3840x2160. Полная таблица: страница обзора.
  • quality: необязательный параметр, эффективен при тестировании (поведение канала, а не обязательство — ориентируйтесь на фактический ответ). Модели 2.5 (gpt-image-2.5-vip = gpt-image-2.5-sunburst-vip, gpt-image-2.5-flare-vip) принимают все шесть уровней: auto / low / medium / high / xhigh / max; gpt-image-2-vip останавливается на high и отклоняет xhigh / max. Одноименные уровни не эквивалентны: 2.5 high соответствует только gpt-image-2-vip medium, а 2.5 max соответствует его high. Фиксированная стоимость $0.03 за изображение не меняется в зависимости от уровня, но более высокие уровни требуют больше времени.
  • n: ❌ отклоняется — одно изображение на вызов.
  • response_format: если опустить, возвращается base64 (чистый, без префикса, проверено в июле 2026 г.); передайте "url" для получения URL изображения. Проектам, для которых критически важен вывод URL, следует переключить свой token на группу image2_OSS для гарантированного вывода URL без отката к base64.

Примеры кода

Python

Редактирование одного изображения:
Объединение нескольких изображений:

cURL

Редактирование одного изображения:
Объединение нескольких изображений:

Node.js (нативные fetch + FormData)

Браузерный JavaScript (объекты File)

Параметры

Итерация в несколько ходов: передавайте предыдущий результат в качестве image следующего вызова вместе с новой инструкцией редактирования для поэтапного улучшения. Для каждого раунда можно указать собственный size.

Формат ответа

Как и в endpoint text-to-image: по умолчанию возвращает base64 (data[0].b64_json, сырой base64 без префикса, проверено в июле 2026). Для URL изображения явно передайте response_format: "url"; компаниям, которым нужен вывод URL, следует перевести свой token в группу image2_OSS для детерминированного вывода URL без fallback на base64. data[0] возвращает либо url, либо b64_json — никогда не оба варианта. Режим b64_json (по умолчанию):
Режим url (явно передайте response_format: "url"; используйте группу image2_OSS, если вам нужны URL):
Проверено в июле 2026: поле b64_json — это сырой base64 без префикса data: — декодируйте его или добавьте префикс самостоятельно перед рендерингом. В более ранних версиях префикс действительно присутствовал, поэтому сначала всегда проверяйте startsWith('data:'), чтобы обработать оба варианта.

Связанные ресурсы

Обзор модели (полная таблица размеров)

Полная таблица 30 размеров, цены, технические характеристики

API для генерации изображений по тексту

/v1/images/generations совместимый эндпоинт

Сопутствующая модель gpt-image-2-all

Тот же формат вызова, когда вам не нужен фиксированный размер — более быстрый вывод

Авторизации

Authorization
string
header
обязательно

API Key from the API易 Console

Тело

multipart/form-data
model
enum<string>
по умолчанию:gpt-image-2.5-vip
обязательно

Model name: gpt-image-2.5-vip (= sunburst-vip) / gpt-image-2.5-flare-vip / gpt-image-2-vip, same price and call format

Доступные опции:
gpt-image-2.5-vip,
gpt-image-2.5-sunburst-vip,
gpt-image-2.5-flare-vip,
gpt-image-2-vip
prompt
string
обязательно

Edit/fusion instruction. For multi-image flows, reference upload order as image1/image2/image3

Пример:

"Place the person from image1 into the scene of image2, in the style of image3"

image
file[]
обязательно

Reference images. For a single image, send the field once; for multiple images, repeat the same image field (e.g., -F [email protected] -F [email protected]) — upload order maps to image1 / image2 / ... in the prompt. Recommended ≤ 10MB each, formats png / jpg / webp.

quality
enum<string>

Quality tier (works in testing; channel behavior, not a commitment — go by the actual response). All six tiers on the 2.5 models (gpt-image-2.5-vip / gpt-image-2.5-sunburst-vip / gpt-image-2.5-flare-vip); gpt-image-2-vip stops at high and rejects xhigh / max. Same-named tiers are not equal: 2.5 high only equals gpt-image-2-vip medium, and 2.5 max equals its high. The flat $0.03 does not change with the tier, but latency rises with it.

Доступные опции:
auto,
low,
medium,
high,
xhigh,
max
Пример:

"high"

size
enum<string>

Output size. For editing, prefer auto (or omit the field) — the model preserves the aspect ratio of whichever reference image the prompt names as the target of the edit (not necessarily the first one in multi-image scenarios). For example, with the prompt "modify image2, change image2's outfit to match image1", the output ratio matches image2. If the prompt doesn't disambiguate, the model decides on its own. To force a different dimension, pick one of the 30 supported sizes; format: WIDTHxHEIGHT with lowercase ASCII x, e.g., 2048x1360, 3840x2160. Flat $0.03/image across all tiers.

Доступные опции:
auto,
1280x1280,
848x1280,
1280x848,
960x1280,
1280x960,
1024x1280,
1280x1024,
720x1280,
1280x720,
1280x544,
2048x2048,
1360x2048,
2048x1360,
1536x2048,
2048x1536,
1632x2048,
2048x1632,
1152x2048,
2048x1152,
2048x864,
2880x2880,
2336x3520,
3520x2336,
2480x3312,
3312x2480,
2560x3216,
3216x2560,
2160x3840,
3840x2160,
3840x1632
Пример:

"2048x1360"

Ответ

Image successfully generated. Defaults to base64 in data[0].b64_json — url is not returned in the same response.

Image editing response. Returns base64 by default (data[0].b64_json); to get a url, switch to the image2_OSS group with response_format=url. data[0] returns either url or b64_json, never both.

data
object[]

Result array (this model returns 1 image per call)

created
integer

Unix timestamp (seconds)

usage
object

Token usage statistics