Introdução
As camadas do Seedream 5.5 transformam um PNG ou JPEG pronto em uma imagem de base opaca e elementos transparentes separados. Use a separação em camadas quando já tiver um design e quiser trabalhar com seus elementos individualmente. Este endpoint aceita uma única origem, enquanto a edição trabalha com um conjunto de referências.
A ByteDance descreve uma imagem de base e até 99 camadas PNG transparentes editáveis. Nossos testes separaram uma capa de revista, um cardápio e um pôster de três linhas. Os resultados demonstram por que a quantidade solicitada funciona como teto: algumas imagens atingiram o limite pedido, enquanto o pôster retornou menos elementos do que o limite permitia.
Recursos e destaques
Uma base com elementos transparentes
A base é opaca, e os elementos separados usam transparência PNG. Escolher jpeg como output_format muda a codificação da base; as camadas continuam chegando como PNGs transparentes. Considere essa diferença ao salvar arquivos para uma composição. A base e as camadas têm funções diferentes no conjunto retornado.
Cada camada inclui nome, caixa delimitadora e zIndex para a ordem de sobreposição. A base não tem caixa delimitadora. Guarde essas informações junto dos arquivos ao organizar os elementos separados em uma ferramenta de design. Cada imagem retornada mantém seu próprio formato.
Um teto que conta a base
num_outputs aceita valores de 2 a 100 e tem 10 como padrão. Conte a base como uma saída ao planejar a separação. Um teto de seis permite, portanto, uma base e cinco camadas transparentes. Um valor maior costuma produzir uma separação mais detalhada, mas o resultado pode conter menos imagens.
Nos nossos testes, um cardápio retornou uma base e cinco camadas com limite de seis. Um pôster de três linhas retornou uma base e três camadas de texto com limite de cinco. O pôster mostra que um teto maior não obriga o modelo a preencher todas as saídas disponíveis.
Nomes em inglês mediante solicitação
Os exemplos da página pedem todos os nomes e descrições das camadas em inglês. Nossos testes retornaram nomes em inglês com essa instrução. Inclua "Escreva todos os nomes e descrições das camadas em inglês" se o seu fluxo de design precisar desse idioma. Mantenha o pedido de idioma separado da lista de elementos a dividir.
Controles de origem e resolução
Forneça um PNG ou JPEG com pelo menos 512 x 512 pixels. As resoluções disponíveis são auto, 1k, 1.5k e 2k, com auto como padrão. Essas são as opções do endpoint de camadas; a configuração 4k da geração e da edição não está disponível para camadas.
| Configuração | Função na separação |
|---|---|
image_url | Fornece a imagem de origem pronta |
| prompt | Indica opcionalmente elementos ou uma região-alvo |
| resolution | Seleciona auto, 1k, 1.5k ou 2k |
num_outputs | Limita todas as imagens retornadas, incluindo a base |
output_format | Seleciona PNG ou JPEG para a imagem de base |
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | Forneça um PNG ou JPEG com pelo menos 512 x 512 pixels. A origem é obrigatória; não há imagem padrão. pelo menos 1 caracteres |
prompt | Não | Opcional. Nomeie os elementos a separar em até 5.000 caracteres. pelo menos 3 caracteres · no máximo 5000 caracteres |
num_outputs | Não | Limita a quantidade total de imagens retornadas, incluindo a base: de 2 a 100, com padrão de 10. |
resolution | Não | Escolhe auto, 1k, 1.5k ou 2k; o padrão é auto. Cada imagem retornada mantém seu próprio formato. |
output_format | Não | Selecione png (padrão) ou jpeg para a base opaca. As camadas separadas continuam sendo PNGs transparentes em ambas as opções. |
Preços
A cobrança segue a faixa de resolução e a quantidade de imagens efetivamente retornadas, incluindo a base. A estimativa reserva o máximo para o limite de saídas solicitado; a diferença é liberada no acerto final. A opção auto reserva a tarifa de 2k.
| Especificação | Preço |
|---|---|
| $0.0195 / imagem |
| $0.0195 / imagem |
| $0.027 / imagem |
| $0.027 / imagem |
Casos de uso
Separar uma capa de revista em elementos de design
Nossa separação da capa NOIR usou limite de seis imagens e retornou seis. Os elementos foram fundo, pessoa, nome da revista, linha em japonês, linha da edição e código de barras. Esse é um exemplo concreto das camadas do Seedream 5.5 em uma capa com fotografia e texto.
Use esse resultado como referência de planejamento quando o design contiver elementos distintos que você quiser separados. Indique as partes relevantes na instrução opcional. Mantenha a origem disponível para comparar os elementos retornados com o layout original.
Desmontar um cardápio para novas composições
O exemplo de camadas do Kaze Ramen parte da imagem pronta do cardápio. Com teto de seis imagens, nossos testes retornaram uma base opaca e cinco camadas transparentes. Salve o conjunto completo se pretende reorganizar os elementos do cardápio juntos depois.
Isolar linhas de texto de um pôster
Nosso teste do pôster de três linhas produziu uma camada transparente para cada linha, além da base. O total foi de quatro imagens, apesar do teto solicitado de cinco. Conte os elementos retornados após a conclusão, pois o limite pedido não garante uma lista de arquivos.
Organizar os elementos pelos metadados retornados
Use o nome para identificar cada camada, a caixa delimitadora para entender sua posição e zIndex para seguir a ordem de sobreposição. Mantenha esses valores vinculados ao arquivo correspondente. Pedir nomes em inglês pode facilitar a organização quando o restante do fluxo de design usa rótulos nesse idioma.
Guia de prompt e dicas práticas
Escolha uma origem pronta com elementos conhecidos
Comece confirmando que o arquivo é PNG ou JPEG e atende ao mínimo de 512 x 512. Decida quais elementos quer separados antes de definir a quantidade. Para uma capa, liste fundo, pessoa, título, texto de apoio e código de barras se essas forem as partes necessárias.
Descreva a separação desejada
O prompt é opcional, então você pode enviar uma origem sem lista de elementos. Quando uma divisão específica importar, escreva uma instrução curta, como "Separe o nome da revista, o subtítulo, a linha da edição e o código de barras." Isso informa à ferramenta de camadas com o que você pretende trabalhar após a separação.
Peça diretamente o idioma dos nomes
Acrescente "Retorne os nomes das camadas em inglês" quando os rótulos precisarem estar nesse idioma. Os exemplos da capa e do cardápio usam esse tipo de instrução. Nossa observação de idioma se refere aos nomes retornados das camadas; ela não significa que o texto impresso na origem deva ser traduzido ou substituído.
Indique uma região com a tag de caixa delimitadora
Para identificar uma área-alvo, use o formato <bbox>x1 y1 x2 y2</bbox> com coordenadas entre 0 e 1000. Por exemplo, <bbox>0 0 1000 300</bbox> identifica uma região ao longo da parte superior da imagem. Após a tag, descreva o elemento a separar para deixar claros a região e seu objetivo.
Escolha a quantidade de acordo com as partes necessárias
Para uma base e cinco camadas planejadas, escolha teto de seis. Se precisar de partes mais detalhadas, um teto maior costuma produzir camadas mais específicas. A configuração continua sendo um limite, sem promessa de quantidade. Compare o conjunto retornado com sua lista de elementos antes de começar a próxima etapa do design.
Separe o formato da base da transparência das camadas
Escolha png ou jpeg de acordo com o arquivo de base necessário. Essa escolha não transforma as camadas separadas em arquivos JPEG. Elas mantêm a codificação PNG transparente em ambas as opções de base. Guarde a base opaca quando a composição completa precisar da imagem subjacente.
Entenda a quantidade de saídas no acerto final
A cobrança de camadas segue a faixa de resolução e a quantidade de imagens efetivamente retornadas, incluindo a base. A estimativa reserva o máximo para o teto solicitado e libera a diferença no acerto final. A resolução auto reserva a tarifa de 2k. Consulte a cobrança exibida na página ao escolher as configurações da solicitação.
Salve o resultado completo em camadas
Baixe juntos a base, os PNGs transparentes e os detalhes de posição. Registre a instrução opcional e o teto de saídas junto deles. Isso preserva a relação entre o design de origem, os arquivos separados, seus nomes e a ordem de sobreposição para a próxima composição.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.5/layer-decomposition",
"input": {
"image_url": "https://example.com/reference.png",
"num_outputs": 10,
"output_format": "png",
"resolution": "auto"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
