gpt-image-2.5-flare API

Используйте точный идентификатор модели gpt-image-2.5-flare. Поле модели должно точно соответствовать этой странице.

Пример выводаgpt-image-2.5-flarePOST /v1/images/generations

Параметры: size=1536x1024quality=mediumn=1

Промпт: Children's picture-book illustration: a small fox carrying a paper lantern through a snowy birch forest at dusk, soft gouache textures, gentle blues and warm orange glow, friendly and calm, no text.

Запрос, по которому был создан этот образец

{
  "model": "gpt-image-2.5-flare",
  "prompt": "Children's picture-book illustration: a small fox carrying a paper lantern through a snowy birch forest at dusk, soft gouache textures, gentle blues and warm orange glow, friendly and calm, no text.",
  "n": 1,
  "size": "1536x1024",
  "quality": "medium"
}

Аутентификация и конечная точка

Используйте ключ API Modelflare с https://modelflare.dev/v1. Точка входа шлюза — POST /v1/images/generations.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Создать изображение

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "high", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

Запросить примечания

GPT Image 2.5 Flare — это быстрое и высококачественное средство по умолчанию для повседневного создания и редактирования; сохраните images[], image[], mask и все элементы управления выходом.

Запрос параметров

GPT Image 2.5 использует OpenAI-совместимый API изображений. Генерация использует JSON; редактирование принимает ссылки на изображения JSON или составные файлы; ответы возвращают данные изображения Base64 в data[].b64_json.

Поле	Обязательно	Примечания
model	Да	gpt-image-2.5-flare
prompt	Да	Инструкция создания или редактирования, 1–32 000 символов.
images[]	Условно	Для редактирования JSON: до 16 объектов file_id или image_url.
images[].file_id	Условно	Идентификатор API загруженного файла
images[].image_url	Условно	URL-адрес изображения или URL-адрес данных Base64; URL-адреса данных ограничены 20 971 520 символами.
image	Условно	Один многочастный исходный файл; используйте image[] для нескольких файлов
image[]	Условно	Для многочастного редактирования: до 16 исходных файлов.
mask	Нет	Альфа-маска соответствует первому исходному формату/размеру и имеет размер менее 50 МБ.
size	Нет	auto или пользовательский WIDTHxHEIGHT; 16-пиксельные кратные, соотношение сторон 1:3–3:1, максимальный край 3840 пикселей и общее количество пикселей 655 360–8 294 400.
quality	Нет	low / medium / high / xhigh / max / auto; по умолчанию auto
background	Нет	auto / opaque / transparent; для прозрачного фона требуется вывод PNG или WebP
output_format	Нет	png/jpeg/webp; по умолчанию png
output_compression	Нет	0–100 для JPEG/WebP, по умолчанию 100; игнорируется для PNG
moderation	Нет	auto / low; по умолчанию auto
n	Нет	1–10 выходов; по умолчанию 1

Пределы отклика и ввода

GPT Image 2.5 Flare и Sunburst поддерживают до 16 входов редактирования. При редактировании JSON используются images[] с file_id или image_url; при многочастном редактировании используется image/image[], при этом размер каждого исходного изображения и маски составляет менее 50 МБ. Подсказки имеют длину от 1 до 32 000 символов; качество поддерживает low/medium/high/xhigh/max/auto; Правила размера: кратность 16 пикселей, соотношение сторон 1:3–3:1, максимальный край 3840 пикселей и общее количество пикселей 655 360–8 294 400. Для прозрачного фона требуется PNG или WebP; сжатие применяется только к JPEG/WebP и игнорируется для PNG. Разрешения выше 2560x1440 являются экспериментальными. Прочитайте data[].b64_json; не отправляйте только DALL·E response_format. Flare — это быстрый и высококачественный вариант по умолчанию для повседневного создания и редактирования; Sunburst предназначен для более точной и контролируемой работы.

Редактировать изображения

GPT Image 2.5 поддерживает ссылки на изображения JSON и загрузку составных файлов через /v1/images/edits. JSON принимает до 16 объектов, используя file_id или image_url; multipart принимает до 16 исходных файлов. Не смешивайте images с image/image[] в одном запросе.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "images": [{"file_id": "file-example123"}, {"image_url": "https://example.com/reference.png"}],
    "prompt": "Keep the product unchanged and replace the background with a warm studio gradient",
    "size": "1536x1024", "quality": "high", "background": "opaque", "output_format": "png", "n": 1
  }'

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2.5-flare" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=Keep the product unchanged and replace the background with a warm studio gradient" \
  -F "size=1536x1024" \
  -F "quality=high" \
  -F "background=opaque" \
  -F "output_format=png" \
  -F "n=1"

Форма ответа

Чтение сгенерированных и отредактированных результатов из data[]. GPT Image 2.5 возвращает данные изображения Base64; не рассматривайте ответ как вывод URL.

Поле	Примечания
created	Время создания в виде временной метки Unix в секундах
data	Результаты создания или редактирования изображений
data[].b64_json	Данные изображения в кодировке Base64
background	Окончательный фоновый режим: opaque или transparent
output_format	Формат возвращаемого изображения: png, jpeg или webp
quality	Используемый уровень качества
size	Окончательные размеры: ШИРИНАxВЫСОТА.

Ошибки и невыполненные задачи

Неверные параметры модели возвращают 4xx с идентификатором запроса; используйте поля ответа и сообщение об ошибке, определенные выбранным типовым контрактом.

Поддерживаемая область применения

На этой странице описаны вызовы создания и редактирования модели Modelflare. Поиск или расширение карты, голосовое управление и управление библиотекой элементов — это API-интерфейсы ресурсов, находящиеся за пределами этой общедоступной поверхности вызова модели, и они не являются обязательными полями запроса.

Цены и выставление счетов

В этой модели используется биллинг на основе токенов. Текущую цену для клиентов, цену по справочному прейскуранту и полную спецификацию см. на странице цен модели .

Заметка

На этой странице документирован публичный интерфейс Modelflare; показанные здесь поля и ограничения соответствуют текущему контракту.