Прозрачные PNG в Seedream 5.5: промпты и проверка альфа-канала

Заявленная встроенная поддержка RGBA в Seedream 5.5 полезна для объектов, которые нужно размещать на разных фонах. Но окончательная проверка — скачанный файл: в нём должна быть настоящая полезная прозрачность, а не белый фон или нарисованная шахматная сетка. Явно задайте требования, сохраните оригинал и проверьте его на тех фонах, где собираетесь использовать.

Здесь приведены промпты и локальный порядок проверки. Мы протестировали код на искусственно созданных файлах, включая отрицательный контрольный пример: полностью непрозрачный RGBA. Эти примеры не генерировались в Seedream 5.5; ни тестовые изображения, ни иллюстрация обложки не являются результатами модели.

Подтвердите доступ и определите требования к объекту

Страница Seedream 5.5 ByteDance описывает прозрачный и полупрозрачный вывод. Доступность продукта и варианты экспорта зависят от сервиса. Перед началом прочитайте руководство по версиям и доступу. В публичном каталоге Ofox, проверенном 10 ноября 2026 года, мы не нашли эту версию. Не отправляйте выдуманный ID 5.5 в существующий эндпоинт 5.0.

Запишите требования макета, в котором будет использован объект. Для товарной наклейки это может быть один целый предмет, прозрачная область вне силуэта, отсутствие подписи, запас пространства по краям и достаточный размер изображения. Для стекла частичная прозрачность может требоваться также внутри силуэта. Это разные задачи.

Решите, нужна ли тень в самом файле. Полностью непрозрачный студийный пол обычно не подходит для изолированного объекта. Полупрозрачная контактная тень бывает полезна, но может конфликтовать с освещением конечного макета. Для универсального вырезанного объекта попросите не добавлять пол и отбрасываемую тень; создайте их отдельно при сборке композиции.

Полный промпт для изолированного предмета

Ниже — непроверенный шаблон для вымышленного эмалевого значка. Он задаёт предмет, композицию и требования к экспорту. Адаптируйте его к поддерживаемым настройкам сервиса: текст промпта не включает скрытые параметры вывода.

Create one isolated enamel badge shaped like a small orange sailboat.
Use a clean black outline, pale blue enamel details and a simple front view.
The complete badge must fit inside the image with clear space around every edge.

Deliver the badge as a reusable transparent asset.
Everything outside the badge silhouette must be transparent, not white,
not gray and not a checkerboard pattern painted into the image.
Keep the badge itself opaque. Do not add a floor, cast shadow, caption,
watermark-like decorative text or extra objects.

If this interface supports an original PNG with alpha, preserve that output.
Do not flatten the asset onto a background for presentation.

Если сервис предоставляет экспорт с прозрачностью или сохранением альфа-канала, выберите его. Мы не называем универсальную настройку: её наличие во всех интерфейсах запуска не проверено. Промпт не заставит формат или способ скачивания сохранять прозрачность, если они её отбрасывают.

Для частичной прозрачности измените описание материала, а не просто добавьте «прозрачный фон»:

Create a single pale amber glass loop with a visible opening through its center.
Keep the outside background and the opening fully transparent.
The glass body should have partial transparency, with subtle edge definition.
Do not fill the opening with white, paint a checkerboard into the image,
or add a photographic scene behind the glass.
Keep the entire loop inside the canvas, with space around its outer edge.

Второй промпт тоже не проверен. Плоское RGBA-изображение смешивает цвет с фоном, но не моделирует автоматически физически правильное преломление любой будущей сцены. Проверьте его в целевом макете: убедительный отдельный предпросмотр не гарантирует реалистичное совмещение.

Скачайте оригинал и проверьте альфа-канал

Используйте скачивание исходного файла в сервисе. Скриншот, скопированный предпросмотр или JPEG-экспорт могут потерять прозрачность, даже если она была в оригинале. Переименование .jpg в .png не добавляет утраченные данные.

Спецификация PNG допускает прозрачность, в том числе альфа-канал, но сам формат PNG её не гарантирует. Даже в RGBA все значения альфа могут быть полностью непрозрачными. В обычном 8-битном альфа-канале 0 означает полную прозрачность, 255 — непрозрачность, промежуточные значения — частичную прозрачность.

Скачайте локальные инструменты проверки. В архиве есть check_alpha.py, небольшие искусственные тестовые файлы, инструменты сравнения правок для соседнего руководства и README. Инструменты не отправляют сетевые запросы и не генерируют изображения через платный API.

Понадобятся Python 3 и Pillow. Команды ниже используют синтаксис виртуального окружения macOS/Linux. В Windows активируйте окружение соответствующей командой вашей оболочки.

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install Pillow
python3 check_alpha.py your-original.png --previews your-original-previews

Запускайте команду из распакованной папки seedream55-checks либо указывайте полные пути к скрипту и изображению. Для сохранения всех сравнений задавайте отдельную папку предпросмотров для каждого исходника.

Скрипт выводит исходные формат, цветовой режим и размеры, а также количество полностью прозрачных, частично прозрачных и непрозрачных пикселей. Ещё он сохраняет три совмещения с белым, тёмным и пурпурным фонами. Преобразование в RGBA служит проверке: оно не создаёт отсутствующую прозрачность и не меняет оригинал. Для совмещения используется API изображений Pillow.

Как читать результат

Универсальной доли прозрачных пикселей для хорошего результата нет. Плотно обрезанный объект может занимать почти весь холст. Крошечный предмет на большом прозрачном поле всё равно может быть непригоден. Числа отвечают на технический вопрос, но не оценивают композицию или точность изображения предмета.

Воспроизведите тест скрипта

В архиве fixtures/transparent.png — искусственный тест размером 100 × 100 пикселей. Он содержит 7 499 полностью прозрачных пикселей, 2 500 непрозрачных и один частично прозрачный. Мы запустили скрипт и проверили эти значения.

python3 check_alpha.py fixtures/transparent.png --previews fixture-transparent
python3 check_alpha.py fixtures/opaque-rgba.png --previews fixture-opaque

Второй пример также сохранён в RGBA, но содержит 10 000 непрозрачных пикселей и ни одного прозрачного. Он не должен проходить проверку прозрачности, несмотря на букву A в названии режима. Этот отрицательный контроль показывает, почему нужно проверять значения альфа, а не только расширение или режим файла.

Эти простые изображения специально созданы для проверки скрипта. Они подтверждают, что код различает известные случаи. Они ничего не говорят о частоте успешных генераций Seedream 5.5, качестве краёв или работе с настоящими фотографиями товаров.

Скриншот локального отчёта на английском языке. Входные изображения созданы для проверки инструмента и не являются результатами Seedream.

Осмотрите края на трёх фонах

Откройте белый, тёмный и пурпурный предпросмотры в целевом размере, затем увеличьте важные края. Используйте просмотрщик, который не обрезает изображение автоматически и не скрывает фон.

На тёмном фоне ищите белую кайму, бледные полупрозрачные края и светлый прямоугольник вокруг объекта. На белом — тёмные ореолы и потерянные светлые детали. На пурпурном — остатки фона, заполненные отверстия и неожиданную полупрозрачность частей, которые должны быть непрозрачными.

Особенно внимательно проверяйте тонкие линии, волосы, сетку, ручки и отверстия. У значка-парусника простой контур; это не делает его показательным тестом для кружевной одежды. Выбирайте области проверки под реальный объект, который нужно передать.

Затем поместите файл в настоящий слайд, макет магазина или редактор. Экспортируйте конечный результат и проверьте ещё раз. Хороший исходник может позже объединиться с фоном или пройти пересчёт пикселей. Сохраняйте его рядом с финальным экспортом, чтобы найти этап появления ошибки.

Что делать с ошибками

Внутри изображения видна шахматная сетка. Переключайтесь между тремя фонами. Если сетка остаётся частью изображения и не меняется вместе с фоном, она нарисована в пикселях. Вернитесь к исходному экспорту или запросите новый результат. Сходство с предпросмотром графического редактора не доказывает прозрачность.

После скачивания файл непрозрачен. Убедитесь, что скачали оригинал, а не предпросмотр, и что экспорт сохраняет альфа-канал. Если сервис выдаёт только непрозрачный файл, отдельно удалите фон или используйте другой поддерживаемый экспорт. Запишите дополнительный этап: это уже не прямая выдача прозрачного файла моделью.

Непрозрачный предмет стал полупрозрачным. Укажите области, которые должны быть непрозрачны. Для значка прозрачная эмаль может быть ошибкой. Меняйте только это требование и сравнивайте новый силуэт с предыдущим.

Тонкие края плохо выглядят на тёмном фоне. Не ограничивайте оценку белым предпросмотром. Проверьте исходный альфа-канал, при необходимости запросите более чистое отделение предмета или аккуратно обработайте края в редакторе. Сохраните версии до и после и повторите сравнение на всех трёх фонах.

Запрос API завершился ошибкой до получения изображения. Проверка альфа-канала не исправляет некорректный запрос. Используйте руководство по ошибкам API изображений для проверки ID, параметров, аутентификации и ответа сервиса. Без документации не переносите параметры прозрачного вывода другой модели в Seedream.

Передайте пригодный для повторного использования файл

Передайте оригинал с прозрачностью, целевой размер размещения и ограничения — например встроенную тень или полупрозрачный материал. Если планируется дальнейшая генеративная правка, сохраните принятую версию с понятным именем и следуйте руководству по контролируемому редактированию.

Для наклеек с текстом примените также проверку надписей на плакатах: настоящая прозрачность не исправляет орфографию. Готовый результат должен иметь и правильное содержание, и нужные свойства файла.