Различия параметров и API GPT-Image

Параметры и особенности использования моделей GPT-Image в API генерации и редактирования изображений.

Настраивайте параметры генерации, редактирования и вывода для выбранной модели. Полные структуры запросов и ответов приведены в разделах Создание изображения и Редактирование изображения.

Применимые модели

Модель	Поддерживаемые API
gpt-image-2.6-sunburstНовый gpt-image-2.6-flareНовый gpt-image-2.5-sunburst gpt-image-2.5-flare gpt-image-2 gpt-image-1.5	OpenAI Images: создание и редактирование изображений

Различия параметров генерации

Поле	Различия
`quality`	2.6 и 2.5 поддерживают `auto/low/medium/high/xhigh/max`; 2 и 1.5 — `auto/low/medium/high`. Во всех случаях по умолчанию используется `auto`
`size`	1.5 поддерживает `auto`, `1024x1024`, `1024x1536`, `1536x1024`; 2 и 2.5 поддерживают произвольные размеры: стороны кратны 16 и не превышают 3840, соотношение сторон — 1:3–3:1, общее число пикселей — 655360–8294400. Размеры свыше 3686400 пикселей экспериментальные
`size` (2.6)	Поддерживаются `auto` и произвольные размеры со сторонами, кратными 16, и соотношением 1:3–3:1. Для GIF также действуют ограничения числа кадров и общего бюджета пикселей; не переносите настройки размеров статичных изображений без изменений
`complexity`	2.6 поддерживает `low/medium/high`, по умолчанию `high`. Управляет планированием до генерации; `quality` управляет детализацией рендеринга. Настраиваются независимо
`background`	Для прозрачного фона явно задайте `transparent` и используйте `png` или `webp` для растрового вывода. JPEG не сохраняет альфа-канал. Прозрачный фон у 2 — официальная предварительная возможность

Различия параметров редактирования

Поле	Различия
`input_fidelity`	1.5 поддерживает `low/high`, по умолчанию `low`; для сохранения деталей входа выберите `high`. 2 всегда обрабатывает изображения с высокой точностью, поэтому поле следует опустить. Для 2.6 его также нужно опустить; не переносите настройки 1.5 напрямую на новые модели
`markup`	2.5 и 2.6 поддерживают редактирование по разметке. Передайте слой PNG с прозрачными областями и размерами первого изображения после коррекции ориентации, а изменения опишите в запросе
`mask`, `markup`	Выберите одно из двух; при нескольких входных изображениях применяется к первому. Маска задаёт область редактирования прозрачностью, а разметка указывает место кругами, стрелками и другими обозначениями
`output_format`	Для результатов редактирования используйте `png/jpeg/webp`; для SVG и GIF используйте API создания изображений

Различия форматов вывода

Поле	Различия
`output_format`	Все шесть моделей поддерживают `png/jpeg/webp`, по умолчанию `png`; генерация в 2.6 также поддерживает `svg/gif`
`output_compression`	Только для `jpeg/webp`, диапазон `0～100`; для PNG, SVG и GIF опускайте
SVG	Для генерации в 2.6 задайте `output_format: "svg"` и `n: 1`; не используйте потоковую выдачу или промежуточные изображения. Декодируйте `data[0].b64_json` и сохраните как `.svg`; содержимое — XML в UTF-8
`svg`	Выбирает модель, создающую SVG, отдельно от модели изображения в верхнеуровневом `model`. Указывайте `svg.model` только при включённом выборе модели SVG; иначе опустите весь объект. `svg.reasoning` и `complexity` изображения управляются независимо
GIF	Для генерации в 2.6 задайте `output_format: "gif"`; не используйте потоковую выдачу, промежуточные изображения или пользовательское сжатие. Декодируйте `data[].b64_json` и сохраните как `.gif`
`frame_count`	Только для GIF, `2～16` кадров, по умолчанию `9`. Число кадров, их размеры и `n` связаны общим бюджетом пикселей; при превышении уменьшите один из параметров
`frame_duration_ms`	Только для GIF, `20～2000` миллисекунд, по умолчанию `200`, с округлением до 10 мс

Примеры запросов

Замените MODEL_ID полным ID модели, предоставленным платформой. Примеры генерации, SVG и GIF ниже используют 2.6; редактирование по разметке использует 2.5 или 2.6.

curl 'https://api.agtcloud.ai/v1/images/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "prompt": "Простой постер открытия кафе с заголовком OPEN TODAY и чёткой типографикой",
    "quality": "medium",
    "complexity": "high",
    "size": "1024x1024",
    "output_format": "png"
  }'