API редактирования изображений по референсам GPT Image 2.5 Sunburst на E2X
GPT Image 2.5 Sunburst edit-image — это эндпоинт редактирования на основе референсных изображений от OpenAI на платформе E2X, доступный по адресу openai/gpt-image-2.5-sunburst/edit-image. Передайте один или несколько исходных URL-адресов в массиве image_urls вместе с инструкцией длиной до 50 000 символов, и модель модифицирует существующий визуал, скомпонует несколько товаров в единую сцену или заменит встроенные надписи. С учетом нашей постоянной скидки 75% редактирование в разрешении 1K стоит $0.0525 за выходное изображение независимо от того, выберете ли вы качество low, medium, high, xhigh или max, что на 75% ниже эталонного тарифа высокого уровня $0.211 на fal.ai.
Генерируете изображение исключительно по текстовому описанию без референсных фотографий? Вызывайте GPT Image 2.5 Sunburst text-to-image, который использует ту же тарифную сетку и требует только параметр prompt. GPT Image 2.5 Sunburst поддерживает все 5 уровней качества (low, medium, high, xhigh, max) в разрешениях 1K, 2K и 4K, тогда как GPT Image 2.5 Flare (edit-image) предназначен для стандартных рабочих процессов с 3 уровнями качества (low, medium, high).
Стоимость редактирования по уровням разрешения и качества
Каждый запрос на редактирование к openai/gpt-image-2.5-sunburst/edit-image начинается с прайсовой базовой ставки $0.03 (30,000 микроцентов), которую наша глобальная скидка 75% снижает до $0.0075 (7,500 микроцентов) перед применением двух коэффициентов параметров:
- Коэффициент
resolution: 1K (по умолчанию) = ×1, 2K = ×2, 4K = ×3.
- Коэффициент
quality: low, medium, high (по умолчанию), xhigh и max имеют единый коэффициент ×7.
Поскольку все пять вариантов quality умножают базовую ставку со скидкой $0.0075 на 7 ($0.0075 × 7 = $0.0525 при 1K), единственным рычагом управления стоимостью является resolution. Вы можете запускать качество high, xhigh или max за ту же самую цену, что и low. Кроме того, в отличие от нашего прежнего маршрута GPT Image 2 edit-image, где поле quality было обязательным, в GPT Image 2.5 Sunburst параметр quality необязателен и по умолчанию равен high.
Полная матрица тарифов за одно редактирование, проверенная 4 ноября 2026 года:
| Выходное разрешение | Тариф E2X со скидкой | Прайсовый тариф без скидки | Общий коэффициент | Аналог на fal.ai | Типичный этап редактирования |
|---|
1K (по умолчанию) | $0.0525 | $0.21 | 1 × 7 | $0.211 (на 75% дороже) | Отладка промптов, тесты текста на этикетках, замена фона |
2K | $0.1050 | $0.42 | 2 × 7 | $0.222 (на 53% дороже) | Предметные фото для e-commerce и главные веб-баннеры |
4K | $0.1575 | $0.63 | 3 × 7 | $0.401 (на 61% дороже) | Готовые к печати композиты и мастер-экспорты высокого разрешения |
Такая структура ценообразования упрощает планирование бюджета на цикл правок. Когда вы корректируете промпт для замены текста на этикетке бутылки или тестируете три разных варианта освещения для вырезанного товара, оставляйте resolution на уровне 1K (по $0.0525 за каждый прогон), сразу используя качество high или xhigh. Пять поисковых правок в 1K плюс один финальный экспорт в 2K ($0.105) обойдутся всего в $0.3675.
Цены и условия использования продуктов могут меняться. Проверяйте актуальные тарифы каждого провайдера перед принятием решения о покупке. Пакетные тарифы Google Batch или Flex не являются прямым эквивалентом стандартного API-запроса по требованию, поскольку условия планирования, доступности и обработки отличаются, поэтому они исключены из данного сравнения. Это целевое сравнение в рамках указанных параметров, а не утверждение, что E2X является самым дешевым вариантом в мире для любой конфигурации.
Основные сценарии редактирования для этого эндпоинта
- Локализация и замена текста на изображении: Передайте эндпоинту готовый постер, развертку упаковки или карточку интерфейса и укажите точную строку для замены в кавычках. Модель обновит слова, сохранив окружающую верстку, перспективу и светотень поверхности нетронутыми.
- Композитинг сцен по нескольким референсам: Передайте массив исходных URL-адресов в
image_urls, чтобы объединить отдельные элементы в один кадр — например, поместить вырезанный товар с изображения 1 на студийный стол с изображения 2 в цветовой палитре изображения 3.
- Точечная замена атрибутов и смена стиля: Сохраняйте геометрию объекта неизменной, меняя материалы, одежду, время суток или фоновое окружение с помощью промпта, описывающего только изменения.
- Расширенный лимит промпта до 50 000 символов: В то время как версия text-to-image ограничивает промпты 32 000 символов,
edit-image принимает до 50 000 символов, предоставляя автоматизированным конвейерам достаточно места для передачи детальных спецификаций верстки, правил фирменного стиля и инструкций для каждого референса.
Запрос к API: отправка исходных URL и опрос статуса
Параметры prompt и image_urls являются двумя обязательными полями в openai/gpt-image-2.5-sunburst/edit-image. Параметры aspect_ratio (по умолчанию 1:1), resolution (по умолчанию 1K) и quality (по умолчанию high) необязательны.
Вот пример вызова curl, который отправляет задачу на редактирование этикетки упаковки с качеством xhigh и разрешением 2K ($0.105):
curl -X POST https://api.e2x.ai/v1/jobs/submit \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-image-2.5-sunburst/edit-image",
"input": {
"prompt": "Change the main label title on the amber glass jar to \"BERGAMOT & CEDAR SOY CANDLE\" in the same serif font and gold foil finish. Keep the apothecary jar shape, wooden lid, and linen backdrop unchanged.",
"image_urls": [
"https://example.com/assets/amber-jar-original.png"
],
"aspect_ratio": "4:5",
"resolution": "2K",
"quality": "xhigh"
}
}'
Ниже приведен полный пример на Node.js, который компонует два референсных изображения в разрешении 1K ($0.0525) и опрашивает задачу до ее завершения:
const headers = {
Authorization: `Bearer ${process.env.E2X_API_KEY}`,
"Content-Type": "application/json",
};
const createJob = await fetch("https://api.e2x.ai/v1/jobs/submit", {
method: "POST",
headers,
body: JSON.stringify({
model: "openai/gpt-image-2.5-sunburst/edit-image",
input: {
prompt: "Place the titanium chronograph watch from image 1 onto the wet slate block in image 2. Match the cool side-lighting from image 2 and keep the sub-dial numerals sharp.",
image_urls: [
"https://example.com/assets/chronograph-front.png",
"https://example.com/assets/wet-slate-surface.jpg",
],
aspect_ratio: "1:1",
resolution: "1K",
quality: "max",
},
}),
}).then((res) => res.json());
const jobId = createJob.data.jobId;
while (true) {
await new Promise((r) => setTimeout(r, 3000));
const statusPayload = await fetch(`https://api.e2x.ai/v1/jobs/${jobId}`, {
headers,
}).then((res) => res.json());
const state = statusPayload.data.status;
if (state === "completed") {
console.log("Edited output URL:", statusPayload.data.outputs[0].url);
break;
}
if (state === "failed" || state === "cancelled") {
throw new Error(statusPayload.data.error?.message || `Edit job ${state}`);
}
}
Каждый URL-адрес внутри image_urls должен быть публично доступен по протоколу HTTPS, чтобы наши воркеры могли загрузить исходный файл. Вы можете изучить полное описание параметров в машиночитаемой спецификации эндпоинта или выполнить интеграцию через наши официальные SDK.
Сравнение эндпоинтов редактирования изображений на E2X
Выбирайте среди шести наших эндпоинтов image-to-image в зависимости от того, что является главным в вашей задаче — типографика, прозрачные вырезки, портретное сходство или стоимость при больших объемах:
| Модель редактирования | Цена 1K | Цена 4K | Макс. разрешение | Ключевое преимущество |
|---|
| GPT Image 2.5 Sunburst edit | $0.0525 | $0.1575 | 4K | Промпты до 50 000 символов, уровни xhigh и max без доплаты, пропорции auto |
| GPT Image 2 edit | $0.0525 | $0.1575 | 4K | Поддержка background: "transparent" для вырезок в PNG с альфа-каналом по той же цене |
| Nano Banana 2.1 edit | $0.0300 | $0.0900 | 4K | Самая низкая цена редактирования в 4K ($0.09) и 15 пропорций до 8:1 |
| Nano Banana Pro edit | $0.0750 | $0.1500 | 4K | Лучшее сохранение черт лица по нескольким референсам персонажа |
| Nano Banana 2 edit | $0.0400 | $0.0800 | 4K | Быстрая повседневная замена фона и цветокоррекция |
| Nano Banana 2 Lite edit | $0.0238 | н/д | 1K | Самая низкая фиксированная цена в 1K для массовой обработки каталогов |
Когда для редактирования требуется прозрачный фон PNG (background: "transparent"), используйте GPT Image 2 edit-image по тому же тарифу $0.0525 (1K), так как gpt-image-2.5-sunburst/edit-image не поддерживает поле background. Когда вам нужны недорогие правки в 4K в больших объемах ($0.09) или сверхширокие баннеры 8:1, используйте Nano Banana 2.1 edit-image. Просмотрите все модели редактирования в категории image-to-image или в полном каталоге моделей.
Как писать эффективные промпты для редактирования
Промпт для редактирования работает лучше всего, когда он описывает требуемое изменение, а не пересказывает все исходное изображение с нуля:
- Укажите, что меняется, а что остается неизменным: Явно перечислите элементы, которые должны остаться нетронутыми («замени деревянную столешницу на матовый каррарский мрамор; оставь керамическую кружку, пар и угол поворота ручки без изменений»).
- Четко нумеруйте несколько референсных изображений: Передавая два или более URL-адреса в
image_urls, ссылайтесь на них по порядковому номеру («возьми кроссовок с изображения 1, помести его на мокрый асфальт улицы с изображения 2 и согласуй неоновые блики с изображением 3»).
- Цитируйте заменяемый текст дословно: Помещайте точный текст для замены в двойные кавычки и указывайте, как он должен соотноситься с существующей типографикой («замени текст на бейдже на "LIMITED EDITION 250ML" тем же узким шрифтом без засечек»).
- Согласуйте соотношение сторон с исходником или используйте
auto: Установка aspect_ratio: "auto" позволяет модели сохранить кадрирование вашего входного изображения, тогда как указание 16:9 или 9:16 дает команду перекадрировать или достроить сцену под новый размер холста.
Больше примеров рабочих процессов на основе референсов вы найдете в нашем руководстве по консистентной генерации изображений и в сравнении моделей Nano Banana.
Часто задаваемые вопросы
Сколько стоит одно редактирование в GPT Image 2.5 Sunburst на E2X?
С учетом нашей скидки 75% редактирование стоит $0.0525 при resolution: "1K" (по умолчанию), $0.105 при 2K и $0.1575 при 4K, независимо от того, установлено ли для quality значение low, medium, high, xhigh или max.
Какие параметры обязательны для эндпоинта edit-image?
Обязательными являются только prompt (до 50 000 символов) и image_urls (массив, содержащий как минимум один публично доступный URL изображения). Параметры aspect_ratio, resolution и quality необязательны и по умолчанию принимают значения "1:1", "1K" и "high".
Чем GPT Image 2.5 Sunburst edit-image отличается от GPT Image 2 edit-image?
Оба эндпоинта используют одинаковую тарифную сетку ($0.0525 за 1K, $0.105 за 2K и $0.1575 за 4K). В GPT Image 2.5 Sunburst параметр quality необязателен и добавляет уровни xhigh и max без дополнительной платы, а aspect_ratio добавляет значение "auto" к 15 фиксированным пропорциям. Однако в gpt-image-2.5-sunburst/edit-image отсутствует параметр прозрачности background, который есть в gpt-image-2/edit-image.
Можно ли передать несколько референсных изображений в одном запросе?
Да. Поле image_urls принимает массив исходных URL-адресов, поэтому вы можете комбинировать объекты, фоны и стилевые референсы в одной задаче. Ссылайтесь на каждое изображение по номеру в вашем промпте («изображение 1», «изображение 2»), чтобы модель понимала роль каждого файла.
Почему лимит промпта здесь составляет 50 000 символов вместо 32 000?
Конвейеры редактирования по референсам часто передают структурированные ограничения макета, OCR-расшифровки существующих этикеток и отдельные инструкции для каждого входного изображения. Потолок в 50 000 символов позволяет вместить такие объемные автоматизированные запросы без обрезки текста.
Как снизить затраты на итерации при тонкой настройке правок?
Оставляйте resolution: "1K", пока тестируете формулировки промпта и расположение объектов в композиции в качестве high, xhigh или max. Каждый прогон в 1K стоит $0.0525 вместо $0.105 (2K) или $0.1575 (4K). Увеличивайте resolution до 2K или 4K только для финального экспорта.
В каких случаях для редактирования лучше выбрать Nano Banana Pro или Nano Banana 2.1?
Выбирайте Nano Banana Pro ($0.075 при 1K), когда главным приоритетом является сохранение портретного сходства конкретного человека с нескольких ракурсов. Выбирайте Nano Banana 2.1 ($0.03 за правки в 1K и $0.09 за правки в 4K), если вам нужна самая низкая цена редактирования в 4K на E2X или экстремальные соотношения сторон 8:1 и 1:8.