Como Usar a API do Seedream 5.5

Seedream 5.5 está disponível no EmpirioLabs. É o modelo de imagem Seedream mais novo da ByteDance, lançado em 9 de novembro de 2026 para geração text-to-image, edições que combinam até 10 imagens de referência, imagens com transparência real feitas a partir de um prompt ou referências, e decomposição de camadas, que divide uma imagem em uma imagem base mais até 99 camadas transparentes e pode ler o texto nelas. Funciona na API e no Playground.

Assista ao filme de lançamento

Todas as imagens do filme foram feitas pela Seedream 5.5 através da API EmpirioLabs a 2K, incluindo um mergulhador ao lado de uma baleia jubarte, uma dançarina de flamenco no meio da rotação, um soprador de vidro no trabalho e um pôster de jazz com letras. A trilha foi gerada pela ACE-Step no EmpirioLabs. Assista no YouTube.

Como se compara

O que ele suporta

• Texto para imagem. Envie um prompt sem imagem.
• Edição e fusão. Anexe de uma a dez imagens e descreva a mudança, ou como combiná-las.
• Edições de marcadores e coordenadas. Marque a área a ser alterada na imagem de entrada com um círculo, seta ou esboço, ou indique sua posição exata como um <bbox> Marque no prompt.
• Imagens transparentes. Definir Contexto para transparente para obter um PNG com um canal alfa, apenas a partir de um prompt ou de imagens de referência.
• Decomposição em camadas. Divida uma imagem em uma imagem base mais até 99 camadas PNG transparentes, cada uma retornada com sua posição na imagem base, um nome e uma descrição.
• Reconhecimento de texto. Durante uma decomposição, obtenha o texto de cada camada de texto impresso com suas posições de linha e estilo.
• Texto na imagem. Placas, etiquetas, cartazes e letras pequenas são apresentados em chinês, inglês e outros 14 idiomas, incluindo japonês, coreano, árabe, espanhol e francês.

A saída é PNG por padrão, ou JPEG, na resolução de 1K, 1,5K ou 2K, ou em largura e altura personalizadas.

Gerar uma imagem

curl https://api.empiriolabs.ai/v1/images/generations \ -H "Autorização: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-Conteúdo: application/json" \ -d '{ "modelo": "seedream-5-5", "prompt": "Uma xícara de café de cerâmica ao lado de uma pequena placa de quadro-negro que diz Oat Flat White 4.50, luz da janela da manhã", "aspect_ratio": "4:3", "qualidade": "2K" }'

O pedido espera a imagem finalizada e a retorna Dados. Adicionar "sync": falso para conseguir um emprego de volta imediatamente, com um job id para votar em VAI /v1/jobs/<job_id> até que seu Status é completo.

A mesma chamada do SDK Python da OpenAI, apontada para EmpirioLabs. Controles que o SDK não define entram extra_body:

from openai import cliente OpenAI = OpenAI(base_url="https://api.empiriolabs.ai/v1", api_key="YOUR_EMPIRIOLABS_API_KEY",) resultado = client.images.generate(model="seedream-5-5", prompt="Um terrário de vidro com uma pequena paisagem de musgo e uma etiqueta de latão que diz Fern Garden", extra_body={"aspect_ratio": "4:3", "quality": "2K"},) print(result.data[0].url)

Faça uma imagem transparente

Definir Contexto para transparente. Funciona apenas com um prompt e em edições de até 10 imagens de referência que não precisam de um canal alfa próprio. A saída deve ser PNG:

{ "modelo": "seedream-5-5", "prompt": "Uma lanterna de papel vermelho brilhante com franjas douradas, recorte isolado do produto", "fundo": "transparente", "qualidade": "1K" }

Cada imagem retornada informa o que ela realmente contém como Contexto: transparente ou Opaco. Vá embora Contexto em Auto, o padrão, e o modelo decide a partir do prompt e do formato de saída.

Editar com imagens de referência

Passe até 10 URLs de imagem, URIs de dados ou imagens enviadas em imagem, e referir-se a eles no prompt pela ordem deles:

{ "modelo": "seedream-5-5", "prompt": "Pendure a lanterna de papel vermelha da imagem 1 do ramo da imagem 2, mantendo todo o resto da imagem 2 inalterado", "imagem": [ "https://example.com/lantern.png", "https://example.com/branch-poster.png" ] }

Editar: uma área marcada

Para alterar uma parte de uma imagem, marque-a na entrada com um círculo, seta ou esboço e descreva a mudança, ou dê a área como um <bbox> Etiqueta. Uma caixa é esquerda superior direita baixo Em uma grade de 0 a 1000 sobre a imagem, seja qual for o tamanho do pixel:

{ "modelo": "seedream-5-5", "prompt": "Adicione um pequeno vaso de vidro com uma única tulipa branca dentro <bbox>do 60 80 300 520</bbox>. Mantenha todo o resto inalterado.", "imagem": "https://example.com/kitchen.png" }

Divida uma imagem em camadas

Definir layer_decomposition para Verdade e anexe exatamente uma imagem. O prompt é opcional: deixe-o de fora para deixar o modelo escolher os elementos, ou nomeie os elementos ou regiões a separar. max_images define o maior número de imagens para retornar, incluindo a imagem base, de 2 a 100, e text_recognition adiciona o texto de cada camada de texto impresso:

curl https://api.empiriolabs.ai/v1/images/generations \ -H "Autorização: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-de-Conteúdo: application/json" \ -d '{ "modelo": "seedream-5-5", "layer_decomposition": verdadeiro, "imagem": "https://example.com/magazine-cover.png", "max_images": 10, "text_recognition": verdadeiro }'

dados[0] é a imagem base, com um z_index de 0. Cada entrada após ela é uma camada PNG transparente com sua ordem de empilhamento, sua caixa na imagem base em pixels (bounding_box.absoluto) e na grade de 0 a 1000 (bounding_box.normalizado), ambos como [esquerda, cima, direita, baixo], e um nome e uma descrição. Uma camada de texto impressa também carrega text_recognition:

{ "url": "https://media.empiriolabs.ai/...", "z_index": 1, "width": 1723, "height": 609, "bounding_box": { "absoluto": [75, 0, 995, 325], "normalizado": [69, 0, 921, 301] }, "name": "Top yellow large seriif title title Seedream", "description": "Large yellow seriif title text \"Seedream\" posicionado no topo da composição.", "text_recognition": { "text": "Seedream", "lines": [ { "bounding_box": { "absoluto": [196, 53, 874, 231], "normalizado": [181, 49, 809, 214] }, "executa": [ { "texto": "Seedream", "estilo": { "similar_font_family": "HTF Didot", "foreground_color": "#F5E25A", "negrito": falso, "itálico": falso, "sublinhado": falso, "riscado": falso, "sombra": falso, "translúcido": falso } } ] } }, "fundo": "transparente" }

Empilhe as camadas sobre a imagem base em ascendente z_index para reconstruí-lo, ou mover, redimensionar, recolorir ou substituir qualquer camada primeiro. Com o texto reconhecido, uma camada pode ser redigitada, traduzida ou reestilizada e colocada de volta na caixa de sua linha.

Coisas para saber antes do seu primeiro pedido

• Uma imagem por pedido. Uma solicitação retorna uma imagem, e n acima de 1 retorna um erro. Envie solicitações separadas para variações. A decomposição em camadas é a exceção: ela retorna a imagem base e suas camadas juntas.
• Definir max_images Para a decomposição que você precisa. Sem ele, uma decomposição pode devolver até 30 imagens, e cada imagem retornada fatura. Um valor maior permite uma divisão mais fina.
• Escale cada camada para sua caixa. Uma camada PNG nem sempre é o tamanho de sua pegada na imagem base: no exemplo acima, uma camada de 1723x609 preenche uma caixa de 920x325. Escale cada camada para a largura e altura de sua bounding_box.absoluto antes de colocá-la no canto superior esquerdo da caixa.
• Reconhecimento de texto lê texto impresso. Letras e caligrafia artísticas voltam como camadas sem text_recognition.
• A decomposição não toma Contexto. Suas camadas são sempre PNG transparentes, e configuração Contexto para transparente ou Opaco com layer_decomposition retorna um erro.
• Um resultado transparente precisa de PNG. Contexto: "Transparente" com output_format: "jpeg" retorna um erro.

Preços

Por imagem. Seedream 5.5 é paga conforme você e fatura por imagem devolvida em seu tamanho: imagens de 1K e 1,5K compartilham uma taxa, e imagens 2K faturam a uma taxa maior. Cada imagem de referência adiciona uma taxa. Uma decomposição de camadas fatura cada imagem que retorna, a imagem base e cada camada, em seu próprio tamanho. Você pode pagar conforme avança, ou escolher um plano com allowances semanais. As taxas atuais estão no página do modelo e o página de preços.

Segurança de conteúdo. Imagens geradas passam por uma verificação automatizada de segurança de conteúdo. Uma imagem sinalizada como explícita não é devolvida e, como foi gerada antes da verificação ser executada, ainda é cobrada.

Comece a construir

Tente Seedream 5.5 no Playground, leia a referência completa do parâmetro no Documentos de API, ou compará-lo com os outros modelos de imagem no Catálogo de modelos. Para os modelos anteriores da família, veja Como usar a API do Seedream 5.0 Pro e Como Usar a API Flash do Seedream 5.0.

Divulgação: Este artigo foi escrito com assistência de IA e revisado por EmpirioLabs IA.