gpt-image-2 API

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

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

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

Промпт: A 24-hour laundromat at three in the morning, a whole wall of front-loaders turning. A young man in a silver metallic bomber jacket has just tipped a jar of coloured glass marbles into the nearest drum. The marbles are pouring upward out of the open door instead of sinking, already arcing across the room in a bright teal and amber bridge that rings against the ceiling lights. Cold cyan tubes overhead, a hard warm amber glow thrown out of the drum itself. Straight-on symmetrical camera, wide, hyper-real detail in the glass, film grain, no text.

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

{
  "model": "gpt-image-2",
  "prompt": "A 24-hour laundromat at three in the morning, a whole wall of front-loaders turning. A young man in a silver metallic bomber jacket has just tipped a jar of coloured glass marbles into the nearest drum. The marbles are pouring upward out of the open door instead of sinking, already arcing across the room in a bright teal and amber bridge that rings against the ceiling lights. Cold cyan tubes overhead, a hard warm amber glow thrown out of the drum itself. Straight-on symmetrical camera, wide, hyper-real detail in the glass, film grain, 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",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1024x1024", "n": 1
  }'

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

Модели изображений, совместимые с OpenAI, используют prompt, n, size и quality; используйте редактирование только тогда, когда это документировано на официальной странице.

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

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

Поле	Обязательно	Примечания
model	Да	gpt-image-2
prompt	Да	Инструкция по созданию или редактированию
size	Нет	auto или пользовательский WIDTHxHEIGHT в соответствии с документированными правилами размера.
quality	Нет	low / medium / high / auto; по умолчанию auto
background	Нет	auto / opaque / transparent; для прозрачного фона требуется вывод PNG или WebP
output_format	Нет	png / jpeg / webp
output_compression	Нет	0–100 для JPEG/WebP, по умолчанию 100; игнорируется для PNG
moderation	Нет	auto / low; по умолчанию auto
n	Нет	1–10 выходов; по умолчанию 1

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

Для нестандартных размеров требуется, чтобы оба края были кратны 16, соотношение сторон от 1:3 до 3:1, максимальная ширина края 3840 пикселей и общее количество пикселей 655 360–8 294 400. Для редактирования допускается до 16 исходных изображений, каждый источник и маска размером до 50 МБ; не отправляйте только DALL·E response_format.

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

GPT Image 2 редактирования используют /v1/images/edits с составными image/image[]; принимается до 16 входных изображений, маска должна соответствовать формату и размерам первого изображения.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=保持主体不变，将背景替换为暖色摄影棚渐变" \
  -F "size=1536x1024" \
  -F "quality=high" \
  -F "output_format=png" \
  -F "n=1"

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

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

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

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

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

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

Заметка

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