API изображений GPT Image 2 – Документация Modelflare

Вызывайте GPT Image 2 через синхронный JSON или SSE с heartbeat и получайте временную подписанную ссылку либо base64.

Создавайте PNG с gpt-image-2 через совместимый с OpenAI Images API. Первая версия создаёт одно изображение за запрос и поддерживает среднее или высокое качество, временную подписанную ссылку либо base64 и необязательный SSE.

Выбор адреса и режима

  • Для синхронного JSON, который может выполняться несколько минут, используйте https://origin.modelflare.dev/v1.
  • Для долгих запросов через Cloudflare используйте https://modelflare.dev/v1 с stream=true; SSE heartbeat поддерживает соединение до готовности изображения.
  • Не перенаправляйте выполняющийся POST между хостами.

Синхронный запрос

curl https://origin.modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"Тихий домик у озера на рассвете","n":1,"quality":"medium","size":"1024x1024","response_format":"url","output_format":"png"}'

Ответ URL содержит приватную подписанную ссылку Modelflare со сроком действия один час. Укажите response_format=b64_json, чтобы получить проверенный PNG без сохранения выходного объекта API.

Актуальная страница Модели и цены показывает цены medium и high для распространённых размеров. Списание рассчитывается по точным качеству и размерам запроса без обычных множителей групп маршрутизации, а итоговая сумма записывается в журнал использования.

SSE-запрос

curl -N https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"Белый кот бежит по неоновой улице под дождём","n":1,"quality":"high","size":"1024x1024","response_format":"url","stream":true}'

Комментарии SSE — только heartbeat. Завершите после image_generation.completed и data: [DONE].

Поддерживаются model, prompt, n=1, quality=medium|high, корректный WIDTHxHEIGHT, response_format=url|b64_json, output_format=png и необязательный stream. Редактирование, вариации, референсные и частичные изображения и неизвестные поля отклоняются. Зарезервированные Credits неуспешных запросов возвращаются идемпотентно по Request ID.

Используйте обычный API-ключ. Ключи, закреплённые за каналом, отклоняются; ключ с ограничением моделей должен включать gpt-image-2.