GPT Image 2

Используйте gpt-image-2 для создания изображения. Эта страница содержит полный запрос, необходимый для этой модели.

Факты о модели

Свойство	Значение
Идентификатор модели	`gpt-image-2`
Эндпоинт	`POST /api/v1/generation/create`
Выход	Изображение
Режимы	текст-в-изображение, изображение-в-изображение
Цены	Посмотреть текущие цены

Минимальный запрос


curl -X POST https://api.apihubs.ru/api/v1/generation/create \
  -H "Authorization: Bearer $API_STOCK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2",
  "input": {
    "prompt": "A cinematic scene with soft natural light"
  }
}'

Ответ на создание содержит идентификатор задачи:


{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "not_started",
    "createdAt": "2026-08-22T12:00:00.000Z"
  }
}

Параметры

Параметры относятся к объекту верхнего уровня input. Неизвестные поля отклоняются.

Параметр	Тип	Обязательный	По умолчанию	Описание
`prompt`	string	Да	—	Запрос пользователя
`urls`	string[]	Нет	—	URL референсных изображений (URL или base64 data URI) для режима image-to-image
`size`	“auto” \| “1:1” \| “16:9” \| “9:16” \| “4:3” \| “3:4” \| “3:2” \| “2:3” \| “5:4” \| “4:5” \| “2:1” \| “1:2” \| “3:1” \| “1:3” \| “21:9” \| “9:21”	Нет	`"1:1"`	Соотношение сторон выходного изображения. Для моделей GPT Image 2.5 соотношения 1:3 и 3:1 требуют разрешения 2k или 4k.
`resolution`	“1k” \| “2k” \| “4k”	Нет	`"1k"`	Разрешение выходного изображения

Режимы

Минимальная генерация


{
  "model": "gpt-image-2",
  "input": {
    "prompt": "A cinematic scene with soft natural light"
  }
}

С URL


{
  "model": "gpt-image-2",
  "input": {
    "prompt": "A cinematic scene with soft natural light",
    "urls": ["https://example.com/input.jpg"]
  }
}

Ограничения

size: разрешено: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21.
resolution: разрешено: 1k, 2k, 4k.

Неверные типы, неподдерживаемые значения перечислений, числа вне диапазона и отсутствующие обязательные поля возвращают HTTP 400 с error.code: "invalid_input". Исправьте запрос, а не пытайтесь выполнить его повторно без изменений.

Результат

Опрашивайте задачу или предоставьте URL верхнего уровня webhook в запросе на создание:


curl https://api.apihubs.ru/api/v1/task/status/$TASK_ID \
  -H "Authorization: Bearer $API_STOCK_KEY"

Успешная медиа-задача возвращает один или несколько файлов:


{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "finished",
    "files": [
      {
        "fileUrl": "https://s3.apihubs.ru/result.png",
        "fileType": "image"
      }
    ],
    "createdTime": "2026-08-22T12:00:00.000Z"
  }
}

Смотрите Задачи и вебхуки для терминальных статусов, повторных попыток и доставки вебхуков.