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-2 | 1K (по умолчанию) / 2K / 4Ksize в пикселях | до 4 (локальный файл) | всегда 1 | за изображение |
gpt-image-2.5-flare | 1K (по умолчанию) / 2K / 4Ksize в пикселях | до 10 (локальный файл) | всегда 1 | за изображение |
gpt-image-2.5-sunburst | 1K (по умолчанию) / 2K / 4Ksize в пикселях | до 10 (локальный файл) | всегда 1 | за изображение |
az-gpt-image-2 | 1K (по умолчанию) / 2K / 4Ksize в пикселях | до 10 (локальный файл / data URI / публичный URL) | до 10 | за токены |
az-gpt-image-2.5-flare | 1K (по умолчанию) / 2K / 4Ksize в пикселях | до 10 (локальный файл / data URI / публичный URL) | до 10 | за токены |
az-gpt-image-2.5-sunburst | 1K (по умолчанию) / 2K / 4Ksize в пикселях | до 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
| Модель | quality | background | output_format | response_format |
|---|---|---|---|---|
gpt-image-2 | low / medium / high | Не поддерживается | Не поддерживается | b64_json / url |
gpt-image-2.5-flare | low / medium / high | Не поддерживается | Не поддерживается | b64_json / url |
gpt-image-2.5-sunburst | low / medium / high | Не поддерживается | Не поддерживается | b64_json / url |
az-gpt-image-2 | low / medium / high / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
az-gpt-image-2.5-flare | low / medium / high / xhigh / max / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
az-gpt-image-2.5-sunburst | low / medium / high / xhigh / max / auto | transparent / opaque / auto | png / webp / jpeg | b64_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).
В таблице ниже — рекомендуемые размеры для каждого уровня, они общие для всех моделей:
| Соотношение | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 3:2 | 1536x1024 | 2400x1600 | 3504x2336 |
| 2:3 | 1024x1536 | 1600x2400 | 2336x3504 |
| 4:3 | 1152x864 | 2048x1536 | 3264x2448 |
| 3:4 | 864x1152 | 1536x2048 | 2448x3264 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 21:9 | 1344x576 | 3024x1296 | 3840x1648 |
| 2:1 | 1408x704 | 2880x1440 | 3840x1920 |
| 1:2 | 704x1408 | 1440x2880 | 1920x3840 |
Если 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"
}'Параметры запроса
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
model | string | Да | Название модели изображений, например gpt-image-2. |
prompt | string | Да | Описание изображения. Рекомендуется указать объект, композицию, стиль, освещение и формат кадра. |
size | string | Нет | Размер в пикселях, правила см. в разделе «Размеры» выше. |
quality | string | Нет | gpt-image-* поддерживают low, medium, high. az-gpt-image-2 поддерживает low, medium, high, auto; az-gpt-image-2.5-* дополнительно поддерживают xhigh и max. Если не указан, генерация идёт с уровнем low. |
n | integer | Нет | Количество изображений. az-gpt-image-* поддерживают от 1 до 10; gpt-image-* возвращают 1 изображение на запрос — если нужно несколько, отправьте несколько запросов. |
response_format | string | Нет | b64_json (по умолчанию) или url. При url возвращается ссылка на изображение на 88API. |
background | string | Нет | Только az-gpt-image-*: transparent, opaque, auto. |
output_format | string | Нет | Только az-gpt-image-*: png (по умолчанию), webp, jpeg. |
output_compression | integer | Нет | Только 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, запрос отправлен не на тот интерфейс.
Веб-поиск DeepSeek
DeepSeek V4.1 Flash ищет актуальную информацию в интернете и указывает источники — через инструмент web_search в Responses API.
API моделей изображений Gemini
Форматы запросов через OpenAI-совместимый протокол и нативный протокол Gemini, соотношения сторон, разрешения и референсы для Gemini 3.1 Flash Image, Nano Banana 2.1 и Gemini 3 Pro Image.