Skip to main content
POST

Аутентификация и заголовки

string
обязательно
Эндпоинты генерации и запроса задач используют API Key платформы для аутентификации Bearer Token. Получите ключ на странице управления API Key.
Для запроса задачи используйте API Key, принадлежащий тому же пользователю платформы.
string
обязательно
При отправке используйте application/json. Генерация по тексту и по изображениям использует тело запроса в формате JSON.

Выбор версии

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

string
обязательно
Фиксированное значение: gpt-image-2.5-ext.
string
по умолчанию:"flare"
Версия модели. Варианты: flare, sunburst.
string
обязательно
Промпт для генерации или редактирования изображения. После удаления пробелов по краям он не должен быть пустым.При генерации по изображениям можно описать, что нужно сохранить и что изменить в референсах.
string
по умолчанию:"1K"
Уровень выходного разрешения. Варианты: 1K, 2K, 4K.
string
по умолчанию:"auto"
Соотношение сторон результата. Выберите auto или одно из следующих 10 соотношений:1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9.
integer
по умолчанию:"1"
Количество изображений для генерации за один запрос. Целое число от 1 до 4.
string[]
Массив из не более чем 16 референсных изображений. Без референсов выполняется генерация по тексту, с референсами — генерация по изображениям. Референсы не оплачиваются отдельно.Поддерживаемые форматы ввода:
  • Доступные URL изображений
  • Data URL: data:image/...;base64,...

Примеры использования

Ниже приведены тела JSON-запросов для POST /v1/images/generations. Используйте аутентификацию и рекомендуемые заголовки, описанные выше. Замените примеры адресов референсов реальными доступными URL изображений.

Генерация по тексту

Генерация по изображениям с Sunburst

Несколько референсов и несколько результатов

Автоматическое соотношение сторон и разрешение 4K

Запрос результатов задачи

Используйте ID задачи для вызова эндпоинта запроса задачи:

Успешная задача

Приведённые ниже ID задачи, время, URL и суммы показывают только структуру ответа и не соответствуют реальной задаче или действующим ценам.

Ответ

integer
Код состояния ответа. При успешной отправке в унифицированном формате возвращается 200.
string
Идентификатор этого запроса для диагностики проблем.
object
Принятая асинхронная задача.