GPT Image 2 Edit

gpt-image-2-edit GPT Image 2 Edit создана для более сильной трансформации исходных изображений и детальной визуальной доработки. Она полезна для продуктовых правок, изменений макета, ретуши и презентационных итераций.

Эндпоинты

POST /v1/queue/gpt-image-2-edit # Создать задачу

GET /v1/queue/gpt-image-2-edit/requests/{request_id}/status # Проверить статус

GET /v1/queue/gpt-image-2-edit/requests/{request_id}/response # Получить результат

PUT /v1/queue/gpt-image-2-edit/requests/{request_id}/cancel # Отменить задачу

Параметры запроса

curl --location "https://api.odirouter.ai/model/v1/queue/gpt-image-2-edit" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "Replace the background with a clean white studio setup while preserving the product details.",
    "images": ["https://example.com/input.png"],
    "n": 1,
    "size": "1024x1024",
    "quality": "medium",
    "background": "auto",
    "output_format": "jpeg",
    "output_compression": 90,
    "moderation": "auto"
  }'

prompt string required

Текстовое описание нужного отредактированного изображения, максимальная длина — 32000 символов.

images any required

Входные референсные изображения для редактирования, поддерживается до 16 входных изображений.

mask any

Маска для выбора редактируемых областей. Прозрачные области считаются редактируемыми. Маска должна совпадать с редактируемым изображением по формату и размерам и содержать альфа-канал. Если параметр не указан, можно редактировать все изображение.

n int

Количество отредактированных изображений для генерации.

Диапазон: 1 - 10

По умолчанию: 1

size string

Размер выходного изображения.

Поддерживает auto, распространенные фиксированные размеры, например 1024x1024, 1024x1536 и 1536x1024, а также пользовательское значение WIDTHxHEIGHT, соответствующее ограничениям размера GPT Image 2.

Требования к пользовательскому размеру: ширина и высота должны быть кратны 16; соотношение сторон не должно превышать 3:1; самая длинная сторона не должна превышать 3840px; общее число пикселей должно быть от 655360 до 8294400.

По умолчанию: auto

quality string

Уровень качества изображения.

Варианты: low, medium, high, auto

По умолчанию: auto

background string

Настройка фона. GPT Image 2 сейчас не поддерживает прозрачный фон transparent. Если передать transparent, сервис может принять запрос, но прозрачный вывод не гарантируется и может быть проигнорирован upstream-сервисом или обработан как непрозрачный фон.

Варианты: auto, opaque

По умолчанию: auto

output_format string

Формат возвращаемого изображения.

Варианты: png, jpeg, webp

По умолчанию: png

output_compression int

Уровень сжатия вывода. Применяется только когда output_format равен jpeg или webp. Например, output_compression=50 сжимает выходное изображение на 50%.

Диапазон: 0 - 100

По умолчанию: 100

moderation string

Строгость модерации контента для запросов генерации GPT Image.

Варианты: auto, low

По умолчанию: auto

user string

Уникальный идентификатор конечного пользователя.

Параметры ответа

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/gpt-image-2-edit/requests/mmsu_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/gpt-image-2-edit/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/gpt-image-2-edit/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	Идентификатор задачи, используемый во всех последующих операциях.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.

Следующие операции