Перейти к содержимому
Основной сайт Новости Консоль

API редактирования изображений

Интерфейс редактирования изображений изменяет исходное изображение по текстовому запросу (смена фона, изменение элементов, стилизация и т. д.), поддерживаются серии изображений GPT-Image и Gemini.

Интерфейс

POST https://api.4allapi.com/v1/images/edits

Формат multipart/form-data, основные поля:

ПолеОписание
modelНазвание модели изображения, например gpt-image-2, gemini-3.1-flash-image
imageФайл исходного изображения (можно несколько, image[])
promptИнструкция для редактирования

Пример

Окно терминала
curl https://api.4allapi.com/v1/images/edits \
-H "Authorization: Bearer $AIPROXY_KEY" \
-F model="gpt-image-2" \
-F image="@product.png" \
-F prompt="Замените фон на уютную рождественскую гостиную, сохранив основной объект товара без изменений"
resp = client.images.edit(
model="gpt-image-2",
image=open("product.png", "rb"),
prompt="Замените фон на сцену заката на пляже",
)
print(resp.data[0].url or resp.data[0].b64_json[:50])

Основные рекомендации

  • При вводе нескольких изображений (например, изображение товара + изображение с эталонным стилем) передавайте несколько полей image по порядку и указывайте в запросе роль каждого изображения;
  • Редактирование также тарифицируется за каждый запуск, а формат/разрешение кадра по-прежнему определяются суффиксом имени модели;
  • Если нужно сохранить一致ность персонажа/товара, прямо укажите в запросе «сохранить основной объект без изменений» и по возможности выбирайте выходной вариант с разрешением, близким к исходному изображению;
  • Стратегия таймаута и повторных попыток такая же, как в Рекомендации по использованию изображений