88API88API
Руководство пользователяAI-приложенияAPIПомощь и поддержка
Изображения (Image)

API моделей изображений OpenAI

Интерфейсы, размеры, уровни качества, референсы и прозрачный фон для моделей изображений gpt-image-2, gpt-image-2.5 и серии az-gpt-image.

Область применения

На этой странице описаны интерфейсы изображений для моделей изображений OpenAI (gpt-image-* и az-gpt-image-*). О моделях изображений Gemini см. API моделей изображений Gemini, о моделях изображений Grok — API моделей изображений Grok.

Официальная документация

Выбор интерфейса

Модели изображений OpenAI работают только через интерфейсы изображений; не используйте вместо них /v1/chat/completions или /v1/responses:

НазначениеМетод запросаКонечная точка
Генерация по текстуPOST/v1/images/generations
Редактирование изображенияPOST/v1/images/edits

Модели и возможности

МодельРазрешениеРеференсыИзображений за запросОплата
gpt-image-21K (по умолчанию) / 2K / 4K
size в пикселях
до 4 (локальный файл)всегда 1за изображение
gpt-image-2.5-flare1K (по умолчанию) / 2K / 4K
size в пикселях
до 10 (локальный файл)всегда 1за изображение
gpt-image-2.5-sunburst1K (по умолчанию) / 2K / 4K
size в пикселях
до 10 (локальный файл)всегда 1за изображение
az-gpt-image-21K (по умолчанию) / 2K / 4K
size в пикселях
до 10 (локальный файл / data URI / публичный URL)до 10за токены
az-gpt-image-2.5-flare1K (по умолчанию) / 2K / 4K
size в пикселях
до 10 (локальный файл / data URI / публичный URL)до 10за токены
az-gpt-image-2.5-sunburst1K (по умолчанию) / 2K / 4K
size в пикселях
до 10 (локальный файл / data URI / публичный URL)до 10за токены

Поддерживаемые соотношения сторон: 1:1 (по умолчанию) / 3:2 / 2:3 / 4:3 / 3:4 / 16:9 / 9:16 / 21:9 / 2:1 / 1:2

Модельqualitybackgroundoutput_formatresponse_format
gpt-image-2low / medium / highНе поддерживаетсяНе поддерживаетсяb64_json / url
gpt-image-2.5-flarelow / medium / highНе поддерживаетсяНе поддерживаетсяb64_json / url
gpt-image-2.5-sunburstlow / medium / highНе поддерживаетсяНе поддерживаетсяb64_json / url
az-gpt-image-2low / medium / high / autotransparent / opaque / autopng / webp / jpegb64_json / url
az-gpt-image-2.5-flarelow / medium / high / xhigh / max / autotransparent / opaque / autopng / webp / jpegb64_json / url
az-gpt-image-2.5-sunburstlow / medium / high / xhigh / max / autotransparent / opaque / autopng / webp / jpegb64_json / url

Обе группы моделей вызываются одинаково, различаются доступные параметры и способ тарификации:

  • gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst: оплата за изображение, цена не зависит от размера и уровня качества. Поддерживают size и quality, каждый запрос возвращает 1 изображение.
  • az-gpt-image-2, az-gpt-image-2.5-flare, az-gpt-image-2.5-sunburst: поддерживают полный набор параметров OpenAI Images, включая прозрачный фон background, формат вывода output_format, несколько изображений за запрос n (до 10), потоковый предпросмотр и запросы на редактирование в формате JSON. Оплата по токенам, стоимость зависит от размера и уровня качества.

Фактически доступные модели определяются списком моделей в консоли.

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

Во всех запросах нужно передавать токен доступа 88API:

Authorization: Bearer $API_KEY
Content-Type: application/json

Размеры

size указывается в пикселях в виде ширинаxвысота; строки вроде 1K, 2K, 4K не принимаются. Допустимый размер должен одновременно удовлетворять условиям:

  • ширина и высота кратны 16;
  • длинная сторона не больше 3840;
  • соотношение длинной и короткой сторон не больше 3:1;
  • общее число пикселей от 655 360 (около 816×816) до 8 294 400 (3840×2160).

В таблице ниже — рекомендуемые размеры для каждого уровня, они общие для всех моделей:

Соотношение1K2K4K
1:11024x10242048x20482880x2880
3:21536x10242400x16003504x2336
2:31024x15361600x24002336x3504
4:31152x8642048x15363264x2448
3:4864x11521536x20482448x3264
16:91280x7202560x14403840x2160
9:16720x12801440x25602160x3840
21:91344x5763024x12963840x1648
2:11408x7042880x14403840x1920
1:2704x14081440x28801920x3840

Если size не передан или равен auto, размер выбирает сама модель. Размеры, не соответствующие правилам выше, могут быть отклонены или автоматически скорректированы, поэтому проверяйте их перед отправкой запроса.

Генерация по тексту

Запрос

curl https://api.88api.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Рыжий кот сидит у окна, естественный дневной свет, реалистичная фотография",
    "size": "2048x2048",
    "quality": "medium"
  }'

Параметры запроса

ПараметрТипОбязательноОписание
modelstringДаНазвание модели изображений, например gpt-image-2.
promptstringДаОписание изображения. Рекомендуется указать объект, композицию, стиль, освещение и формат кадра.
sizestringНетРазмер в пикселях, правила см. в разделе «Размеры» выше.
qualitystringНетgpt-image-* поддерживают low, medium, high. az-gpt-image-2 поддерживает low, medium, high, auto; az-gpt-image-2.5-* дополнительно поддерживают xhigh и max. Если не указан, генерация идёт с уровнем low.
nintegerНетКоличество изображений. az-gpt-image-* поддерживают от 1 до 10; gpt-image-* возвращают 1 изображение на запрос — если нужно несколько, отправьте несколько запросов.
response_formatstringНетb64_json (по умолчанию) или url. При url возвращается ссылка на изображение на 88API.
backgroundstringНетТолько az-gpt-image-*: transparent, opaque, auto.
output_formatstringНетТолько az-gpt-image-*: png (по умолчанию), webp, jpeg.
output_compressionintegerНетТолько az-gpt-image-*, от 0 до 100, действует только для jpeg и webp.

Пример ответа

{
  "created": 1760000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgo..."
    }
  ]
}

По умолчанию возвращается data[].b64_json; если в запросе указать "response_format": "url", возвращается data[].url.

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

Для редактирования изображений используется /v1/images/edits. Локальные изображения загружаются через multipart/form-data; для нескольких референсов повторяйте поле image[]. Допускается до 10 изображений (для gpt-image-2 — до 4) в форматах PNG, JPEG, WebP.

curl https://api.88api.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[]=@person.png" \
  -F "image[]=@product.png" \
  -F "prompt=Пусть человек с первого изображения держит в руках продукт со второго изображения, внешний вид человека и продукта не менять" \
  -F "size=1536x1024"

Референсы нумеруются в порядке загрузки, в промпте на них можно ссылаться как на «первое изображение», «второе изображение».

Запрос на редактирование в формате JSON (только az-gpt-image-*)

az-gpt-image-* также поддерживают запросы на редактирование в формате JSON; референсом может быть Data URI или публичный URL:

curl https://api.88api.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "az-gpt-image-2.5-flare",
    "prompt": "Заменить фон на светло-голубую фотостудию",
    "images": [
      { "image_url": "data:image/png;base64,..." },
      { "image_url": "https://example.com/reference.png" }
    ],
    "size": "1024x1024"
  }'

Для gpt-image-* используйте загрузку через multipart.

Прозрачный фон (только az-gpt-image-*)

Для стикеров, иконок или вырезанных объектов на прозрачном фоне задайте background равным transparent и используйте вывод в png или webp:

curl https://api.88api.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "az-gpt-image-2",
    "prompt": "Стикер с пандой, которая держит табличку «Вперёд!», чистая обводка",
    "size": "1024x1024",
    "background": "transparent",
    "output_format": "png"
  }'
  • jpeg не поддерживает прозрачность: в сочетании с transparent вернётся непрозрачное изображение.
  • При редактировании transparent позволяет удалить фон; если сам референс прозрачный, прозрачность сохранится и в результате.
  • opaque не гарантирует полностью непрозрачный результат: если промпт явно просит «стикер» или «без фона», изображение всё равно может вернуться прозрачным.

Потоковый предпросмотр (только az-gpt-image-*)

Если задать "stream": true и "partial_images" от 1 до 3, интерфейс возвращает через SSE промежуточные превью image_generation.partial_image, а последнее событие image_generation.completed содержит итоговое изображение и данные об использовании; у запросов на редактирование события называются image_edit.*.

Тарификация

  • gpt-image-* тарифицируются по числу успешно возвращённых изображений, независимо от размера и уровня качества.
  • az-gpt-image-* тарифицируются по токенам: текстовый ввод, ввод изображений (референсы) и вывод изображений оцениваются отдельно. Выходные токены зависят только от размера и уровня качества — чем выше уровень, тем выше стоимость; у az-gpt-image-2.5-* при одноимённом уровне токенов меньше, чем у az-gpt-image-2 (high у 2.5 примерно соответствует medium у 2).
  • За неудачные запросы плата не взимается.

Важные ограничения

  • Не отправляйте запросы этих моделей на /v1/responses или /v1/chat/completions.
  • Локальная перерисовка по mask не поддерживается: переданная маска не используется для перерисовки области — если нужно изменить часть изображения, опишите её расположение в промпте.
  • Параметр input_fidelity не поддерживается.
  • Не рекомендуется использовать GIF в качестве референса — сначала конвертируйте его в PNG.
  • Высокие уровни качества и размеры 4K могут занимать 1–2 минуты, уровень max у az-gpt-image-2.5-* — до 2,5 минут; рекомендуем ставить тайм-аут клиента не меньше 5 минут.
  • Если возвращается Invalid size ..., проверьте size по правилам из раздела «Размеры» выше.
  • Если возвращается This model does not support image generation. или image_model_wrong_endpoint, запрос отправлен не на тот интерфейс.