Introdução
O Seedream 5.0 Pro Layer Decomposition divide uma imagem pronta em uma imagem base e até dezesseis camadas PNG transparentes. Cada camada vem com uma caixa de posição e um nome, para você reconstruir a composição original ou reorganizá-la num canvas.
Desenvolvido pela ByteDance (ID de modelo dola-seedream-5-0-pro-260628). Use quando as camadas precisarem voltar exatamente ao lugar de origem.
Escolha o modo pelo material de partida
| Material de partida | Modo |
|---|---|
| Uma imagem pronta cujas partes você precisa separadas | Seedream 5.0 Pro Separação em camadas |
| Uma direção de arte ou um brief de design por escrito | Seedream 5.0 Pro Texto para imagem |
| Uma imagem de origem aprovada para revisar | Seedream 5.0 Pro Edição de imagem |
| A mesma separação, também com nomes e caixas de posição, com preço por imagem menor | Seedream 5.0 Flash Separação em camadas |
Pro ou Flash para camadas
As duas faixas devolvem boundingBox e name para cada camada. No mesmo pôster de cinema, executado sem prompt, o Pro devolveu nove imagens e o Flash oito. As diferenças são o preço e um limite de conteúdo. O Pro custa $0.042 por imagem de saída em 1K e 1.5K e $0.084 em 2K; o Flash custa $0.026 em qualquer faixa. O Pro recusa imagens de origem no nível Muito forte, enquanto o Flash dividiu o mesmo tipo de imagem em suas figuras. Nenhum dos dois foi consistentemente mais rápido nos nossos testes.
Recursos e destaques
Caixas de posição e nomes
Cada camada devolve boundingBox como [x1, y1, x2, y2] em pixels da imagem base e um name como “Woman in red trench coat”. No nosso teste com o pôster, empilhar as camadas nas suas caixas reproduziu o pôster original. O PNG de uma camada costuma ser maior que a caixa que ocupa (uma caixa de 671 por 139 veio com um PNG de 1233 por 256), então reduza-o para caber na caixa ao recolocá-lo.
Imagem base limpa
Os elementos separados são removidos e o fundo é completado. Ao dividir o anúncio de perfume, sobrou uma superfície de mármore preto vazia onde ficavam o frasco, a fita e as letras.
Conduza com palavras ou coordenadas
Nomeie os elementos ou fixe-os com coordenadas <bbox>. Sem prompt, o modelo escolhe sozinho os elementos principais.
Camadas PNG transparentes
As camadas são sempre PNG transparentes, qualquer que seja o output_format escolhido. Essa opção só muda a imagem base.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | Uma imagem para dividir: png, jpeg, webp, bmp, tiff ou gif, de até 30 MB, de 262.144 a 36.000.000 de pixels no total, com proporção entre 1:16 e 16:1. HEIC não é suportado. pelo menos 1 caracteres |
prompt | Não | Opcional, de qualquer tamanho. Deixe vazio e o modelo escolhe sozinho os elementos principais; nomeie elementos e ele separa esses. pelo menos 1 caracteres · no máximo 5000 caracteres |
resolution | Não | auto, 1k, 1.5k ou 2k. A imagem base mantém a proporção da entrada e cada camada mantém as proporções do seu elemento. |
output_format | Não | jpeg ou png só para a imagem base. As camadas são sempre PNG transparentes, qualquer que seja a sua escolha. |
Preços
| Especificação | Preço |
|---|---|
| $0.042 / imagem |
| $0.042 / imagem |
| $0.084 / imagem |
| $0.084 / imagem |
Casos de uso
Trocar as palavras de um pôster
Tire a camada do título, substitua ou reestilize, e empilhe tudo de volta nas caixas devolvidas.
Trocar o fundo de um produto
Extraia o produto e suas letras de um anúncio, mantenha a imagem base ou substitua, e recomponha para uma nova campanha.
Criar recursos de parallax ou animação
Transforme uma ilustração em camadas ordenadas com posições conhecidas, prontas para movimento de profundidade ou rig.
Isolar uma pessoa de uma cena
Peça só a pessoa e receba uma camada transparente mais a cena sem ela.
Guia de prompt e dicas práticas
Nomeie as peças que você quer
Para um pôster, liste-as em palavras simples: “Separate the diner building, the tagline, the LATE SHIFT title, the woman in the red trench coat and the ADMIT ONE ticket stub.” Essa execução devolveu seis imagens: a imagem base e exatamente essas cinco camadas.
Circule um elemento com uma caixa delimitadora
Acrescente <bbox>x1 y1 x2 y2</bbox> depois do nome do elemento. As coordenadas são normalizadas de 0 a 1000 a partir do canto superior esquerdo, então não dependem do tamanho em pixels da imagem.
Separate the title text <bbox>179 58 809 197</bbox> and the parrot <bbox>330 274 641 991</bbox> into independent layers
Escolha uma resolução
1k e 1.5k custam o mesmo por imagem de saída; 2k e auto são cobrados pela tarifa de 2K porque auto pode produzir saída em 2K. Use 1k ou 1.5k quando só precisar de uma separação de trabalho.
Conte com a reserva
Uma requisição reserva o custo de 17 imagens e devolve a diferença quando o número real de camadas é conhecido. Resultados típicos são poucas imagens.
Limites de conteúdo
Seedream 5.0 Pro · Layer Decomposition. A SpicyAPI não adiciona nenhum filtro de conteúdo na plataforma neste endpoint. As restrições do modelo continuam valendo e os resultados não são garantidos. Em nossos testes, separou todas as imagens de origem sem filtro que tentamos, exceto as do nível Muito forte, que o modelo recusou sem cobrança. Você é responsável por cumprir nossa política de conteúdo.
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.0-pro/layer-decomposition",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"resolution": "1.5k"
}
}'
# 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.
