gpt-image-2.5-sunburst API

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

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

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

Промпт: The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.

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

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.",
  "n": 1,
  "size": "1536x1024"
}

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

Используйте ключ 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-sunburst",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

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

GPT Image 2.5 Sunburst нацелен на создание и редактирование с более высокой точностью и более строгим контролем; сохраните images[], image[], mask, xhigh/max и элементы управления выходом для обеих операций.

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

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

Поле	Обязательно	Примечания
model	Да	gpt-image-2.5-sunburst
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-sunburst",
    "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": "xhigh", "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-sunburst" \
  -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=xhigh" \
  -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; показанные здесь поля и ограничения соответствуют текущему контракту.