Skip to main content
POST
Редактирование изображения

Authorizations

Authorization
string
header
required

Заголовок авторизации вида Bearer <token>, где <token> — ваш API-ключ.

Body

multipart/form-data
model
enum<string>
required

Идентификатор image-модели.

Available options:
gpt-image-2
Example:

"gpt-image-2"

prompt
string
required

Текстовое описание желаемых изменений.

Example:

"Замени фон на закат над морем"

image
file
required

Исходное изображение для редактирования, передаётся файлом.

size
string
default:1024x1024

Размер итогового изображения в формате ШИРИНАxВЫСОТА. Допустимо любое разрешение, если выполнены все четыре условия:

  • обе стороны кратны 16 пикселям;
  • длинная сторона не больше 3840 px;
  • соотношение сторон в пределах от 1:3 до 3:1;
  • общее число пикселей (ширина × высота) — от 655 360 до 8 294 400.
Example:

"1024x1024"

response_format
enum<string>
default:b64_json

Формат, в котором возвращается изображение:

  • url — в поле url приходит ссылка на готовое изображение;
  • b64_json — в поле b64_json приходит изображение, закодированное в base64.
Available options:
url,
b64_json

Response

200 - application/json

Изображение отредактировано

data
object[]

Список сгенерированных изображений. Каждый элемент содержит либо url, либо b64_json — в зависимости от параметра response_format.