PNG transparente no Seedream 5.5: prompts e verificação de alfa

A capacidade de RGBA nativa anunciada pelo Seedream 5.5 é relevante quando você precisa de um ativo que possa ser usado sobre diferentes fundos. O teste final é o arquivo baixado: ele deve conter transparência útil, não um fundo branco ou um padrão quadriculado que apenas represente transparência. Peça o ativo explicitamente, preserve o download original e inspecione-o nos fundos onde você irá usá-lo.

Este guia fornece prompts e um fluxo de trabalho de verificação local. Testamos o código de verificação com arquivos sintéticos, incluindo um controle negativo RGBA opaco. Nós não geramos estes exemplos com Seedream 5.5; nem os arquivos de teste nem a ilustração da capa representam um resultado do modelo.

Confirme o acesso e defina o ativo

A página do Seedream 5.5 da ByteDance descreve saída transparente e semi-transparente. As opções de implantação e exportação de produtos ainda dependem do serviço que você usa. Verifique nosso guia de versões e acesso antes de começar. No catálogo público do Ofox verificado em 10 de novembro de 2026, nós não encontramos esta versão; não envie um ID 5.5 inventado para um endpoint 5.0 existente.

Escreva o que o projeto de destino precisa. Para um adesivo de produto, isso pode significar um objeto completo, uma área transparente fora da silhueta, sem legenda, espaço suficiente em torno da borda e uma saída grande o suficiente para a colocação pretendida. Para um objeto de vidro, alguns pixels dentro da silhueta também podem precisar de transparência parcial. São requisitos diferentes.

Decida se uma sombra pertence ao ativo. Um chão de estúdio totalmente opaco é geralmente errado para um recorte isolado. Uma sombra de contato translúcida pode ser útil, mas pode parecer errada sobre um destino com luz incompatível. Se você precisar de um recorte de produto reutilizável, peça uma imagem sem piso nem sombra projetada e adicione-os deliberadamente durante a composição.

Um prompt completo para um objeto isolado

Aqui está um modelo de prompt não testado para um broche esmaltado fictício. Contém um objeto concreto, composição e exigência de exportação. Adapte-o aos controles suportados pelo seu serviço em vez de assumir que o prompt permite um parâmetro de saída oculto.

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.

Escolha a opção de exportação transparente ou de preservação alfa se o serviço oferecer essa opção. Nós não estamos nomeando uma opção universal porque ela não foi verificada em todas as interfaces em que o modelo está sendo disponibilizado. Um prompt não pode fazer um formato de exportação suportar transparência se esse formato ou caminho de download a descartar.

Para transparência parcial, altere o requisito material em vez de apenas adicionar “fundo transparente”:

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.

Este segundo prompt também não foi testado. Um recurso RGBA plano pode misturar cor com um fundo, mas não simula automaticamente refração fisicamente correta de cada cena futura. Verifique-o em seu destino em vez de presumir que uma prévia isolada convincente garanta uma composição realista.

Baixe o original e, em seguida, verifique alfa

Use o download do arquivo original do serviço. Uma captura de tela, pré-visualização copiada ou exportação JPEG pode perder transparência, mesmo que o ativo original tenha tido. Renomear um arquivo .jpg para .png não adiciona a informação em falta.

A especificação do PNG permite transparência, incluindo alfa; PNG não é uma garantia de que a transparência está presente. Até mesmo um arquivo rotulado RGBA pode ter cada valor alfa configurado para totalmente opaco. Para alfa normal de 8 bits, zero significa transparente e 255 significa opaco, com valores intermediários entre eles.

Baixe o kit de verificação local. Ele contém check_alpha.py, pequenas imagens sintéticas de teste, ferramentas de verificação de edição para o tutorial relacionado e um README. Nada neste kit envia uma solicitação de rede ou gera uma imagem através de uma API paga.

Use Python 3 e Pillow. Esses comandos de terminal usam a sintaxe de ambiente virtual do macOS/Linux; no Windows, ative o ambiente usando o comando equivalente do shell.

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

Execute o comando do diretório seedream55-checks extraído, ou forneça o caminho completo para o script e imagem. Use um diretório de prévias diferente para cada entrada, se você quiser reter todas as comparações.

O script relata o formato de origem, modo de origem, dimensões e contagens de pixels totalmente transparentes, parcialmente transparentes e opacos. Também salva três compósitos em fundo branco, escuro e magenta. Sua conversão para RGBA é para inspeção; ela não cria transparência ausente nem altera o arquivo original. A implementação da composição segue a API de imagens do Pillow.

Interpretar corretamente o resultado

Não há uma porcentagem universal de pixels transparentes que faça um ativo bom. Um objeto bem cortado pode ocupar a maior parte da tela. Um objeto minúsculo pode ter muita transparência, mas ainda ser inutilizável. As contagens respondem a uma pergunta técnica; não julgam a composição ou a fidelidade do objeto.

Reproduzir o teste de verificação antes de confiar nele

O arquivo fixtures/transparent.png incluído é uma imagem sintética de 100 × 100 pixels. Contém 7.499 pixels totalmente transparentes, 2.500 pixels opacos e um pixel parcialmente transparente. Executamos o verificador e confirmamos essas contagens.

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

O segundo arquivo de teste também é armazenado como RGBA, mas tem 10.000 pixels opacos e nenhum pixel transparente. Ele não atende ao requisito de transparência, mesmo que seu modo inclui a letra A. Este controle negativo é a razão para inspecionar valores alfa em vez de confiar apenas em um nome de arquivo ou rótulo de modo.

Essas imagens de teste foram criadas para o verificador e são simples de propósito. Provam que o código distingue os casos conhecidos. Eles não dizem nada sobre a taxa de sucesso de geração da Seedream 5.5, qualidade de borda ou desempenho em fotografias de produtos reais.

Captura no navegador do relatório local de testes em inglês. As entradas são imagens sintéticas para testar o verificador, não saídas do Seedream.

Inspecionar as bordas em três fundos

Abra as pré-visualizações salvas em branco, escuro e magenta no tamanho de colocação pretendido, depois amplie as bordas importantes. Use um visualizador que não recorte automaticamente a imagem ou esconda seu fundo.

No escuro, procure franjas brancas, bordas semitransparentes lavadas e um retângulo pálido ao redor do objeto. Em branco, procure halos escuros e detalhes de luz ausentes. Em magenta, procure por ilhas de fundo não removidas, buracos que devem ser vazios e partes inesperadamente translúcidas de um objeto opaco.

Preste particular atenção às linhas finas, cabelo, malha, alças e aberturas. Um broche em forma de veleiro tem um contorno relativamente simples; isso não o torna uma referência adequada para uma roupa de renda. Escolha áreas de inspeção que correspondam ao ativo real que você precisa entregar.

Em seguida, coloque o arquivo no slide real, layout da loja ou ferramenta de design. Exporte o arquivo final e inspecione-o novamente. Um arquivo original correto pode ser achatado ou reamostrado mais tarde no fluxo de trabalho. Preserve o original ao lado da exportação final para que você possa identificar qual etapa introduziu um problema.

O que fazer quando o resultado está errado

Um tabuleiro de xadrez aparece dentro da imagem. Troque entre os três compósitos. Se o quadriculado continuar preso ao objeto como pixels, em vez de mudar com o fundo, ele está incorporado à imagem. Volte à exportação original ou solicite uma nova saída. Não chame de transparente apenas porque uma pré-visualização se assemelha a um editor gráfico.

O arquivo é opaco após o download. Confirme que você baixou o original em vez de uma prévia e que a exportação preserva o alfa. Se o serviço apenas dá um resultado opaco, use um fluxo de trabalho de remoção de fundo deliberado ou outro caminho de exportação suportado. Registre essa etapa extra; não é entrega nativa transparente.

Um objeto opaco fica translúcido. Especifique quais regiões devem ser opacas. Para um broche, esmalte transparente pode ser uma mudança indesejada. Revise apenas esse requisito e compare a nova silhueta com a versão anterior.

As bordas finas ficam incorretas sobre fundos escuros. Não corrija o problema julgando apenas a visualização em branco. Inspecione o alfa original, solicite um recorte mais limpo, se for adequado, ou faça limpeza de borda controlada em um editor. Mantenha uma cópia antes/depois e repita os três compósitos.

A solicitação da API falha antes de qualquer imagem chegar. A inspeção alfa não pode resolver uma solicitação inválida. Use o guia de resolução de problemas da API da imagem (em inglês) para IDs, parâmetros, autenticação e erros retornados. Não copie nomes de parâmetros de saída transparente de outro modelo em uma rota Seedream sem documentação.

Entregue um ativo que alguém possa reutilizar

Entregue o arquivo transparente original, o tamanho de colocação pretendido e quaisquer limitações, como uma sombra incorporada ou material semitransparente. Se o ativo sofrer mais geração, mantenha o arquivo aceito como um ponto de controle identificado e siga o guia de edição controlado.

Para adesivos baseados em texto, também use o processo de verificação de texto do poster: transparência real não faz a ortografia correta. Uma entrega bem-sucedida precisa tanto do conteúdo certo quanto do comportamento correto do arquivo.