Skip to main content
POST
Генерация изображения

Authorizations

Authorization
string
header
required

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

Body

application/json
model
enum<string>
required

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

Available options:
gpt-image-2
Example:

"gpt-image-2"

prompt
string
required

Текстовое описание желаемого изображения.

Example:

"Рыжий кот в космическом скафандре на фоне звёзд"

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.