Настоящий альфа-канал в OpenAI Image API: как генерировать и проверять прозрачные PNG

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

На практике при работе с генеративными моделями возникают две проблемы:

1. Модель рисует шахматную сетку прозрачности прямо в растре (псевдопрозрачность), возвращая обычное непрозрачное изображение.
2. Файл содержит альфа-канал, но контуры объекта окружены каймой или паразитными ореолами (fringing), из-за чего изображение неаккуратно смотрится на произвольном фоне.

Параметр API позволяет запросить прозрачный фон, однако результат и качество краев все равно требуют проверки. Ниже разберем, как настроить запрос, составить промпт и быстро проверить полученный PNG.

---

1. Настройки API и промпт

Редактирование существующих изображений (Edits) — отдельная задача; здесь мы рассматриваем генерацию нового ассета с нуля (Generations).

В OpenAI Image Generation Guide прозрачность задается комбинацией двух параметров:

• background: принимает значения transparent, opaque или auto. Для прозрачного фона указывается transparent.
• output_format: указывается png (или webp), так как jpeg не поддерживает альфа-канал.

Параметр в API запрашивает прозрачность на уровне формата, но в промпте необходимо явно изолировать объект и запретить лишнее окружение.

Рекомендации из OpenAI Image Prompting Guide помогают отсечь паразитные элементы:

An isolated 3D isometric glass cube with glowing layered circuit boards inside, modern tech UI asset, smooth glossy reflections, crisp defined edges, centered composition, fully isolated on a transparent background, no drop shadow, no solid backdrop, no floor reflection, no checkerboard pattern.

В описании зафиксированы предмет и четкие границы (crisp defined edges), а также прямо исключены тени (no drop shadow), подложки (no solid backdrop) и нарисованная сетка (no checkerboard pattern).

---

2. Генерация изображения через Python API

Для запроса к API используется официальная библиотека openai:

import base64
from openai import OpenAI

client = OpenAI()

prompt = (
    "An isolated 3D isometric glass cube with glowing layered circuit boards inside, "
    "modern tech UI asset, smooth glossy reflections, crisp defined edges, "
    "centered composition, fully isolated on a transparent background, "
    "no drop shadow, no solid backdrop, no floor reflection, no checkerboard pattern"
)

response = client.images.generate(
    model="gpt-image-2.5-flare",
    prompt=prompt,
    background="transparent",
    output_format="png",
)

image_b64 = response.data[0].b64_json
image_bytes = base64.b64decode(image_b64)

with open("ui_cube_asset.png", "wb") as file:
    file.write(image_bytes)

---

3. Проверка альфа-канала и краев в Pillow

Формальное наличие альфа-канала не гарантирует идеальные контуры: вокруг объекта могут оставаться светлые или темные ореолы, а также полупрозрачный шум.

Базовая проверка файла включает:

1. Подтверждение режима RGBA как ожидаемого для PNG с прозрачностью.
2. Контроль крайних состояний: в файле должны присутствовать как видимые пиксели, так и прозрачные области (файл не должен быть полностью пустым или полностью глухим).
3. Композитинг на контрастную светлую и темную подложки для визуальной оценки чистоты контура.

Компактный пример проверки с помощью Pillow:

from PIL import Image

def verify_and_composite(image_path: str):
    with Image.open(image_path) as img:
        # Проверяем ожидаемый режим RGBA
        if img.mode != "RGBA":
            print("Ошибка: изображение не в режиме RGBA.")
            return

        # Проверяем наличие прозрачных и видимых пикселей
        alpha = img.getchannel("A")
        min_alpha, max_alpha = alpha.getextrema()

        if max_alpha == 0:
            print("Предупреждение: изображение полностью прозрачно.")
            return
        if min_alpha == 255:
            print("Предупреждение: изображение полностью непрозрачно.")
            return

        # Наложение на светлый фон (для выявления темной каймы)
        bg_light = Image.new("RGBA", img.size, (255, 255, 255, 255))
        Image.alpha_composite(bg_light, img).convert("RGB").save("preview_light.png")

        # Наложение на темный фон (для выявления белых ореолов)
        bg_dark = Image.new("RGBA", img.size, (17, 24, 39, 255))
        Image.alpha_composite(bg_dark, img).convert("RGB").save("preview_dark.png")

Созданные превью позволяют быстро оценить края объекта: контур должен плавно ложиться на светлую и темную поверхности без посторонней каймы и запеченного фона.

---

Официальные источники

• OpenAI Image Generation Guide
• OpenAI Image Prompting Guide