Como Usar a API Flash do Seedream 5.0

Seedream 5.0 Flash está disponível no EmpirioLabs. É o modelo rápido de imagens Seedream da ByteDance para geração text-to-image, edições que combinam até 10 imagens de referência, edições precisas feitas com coordenadas ou marcadores desenhados, e decomposição de camadas, que divide uma imagem em uma imagem base mais até 16 camadas transparentes. Funciona tanto na API quanto na Playground.

Assista ao filme de lançamento

Cada imagem do filme é uma saída real do Flash Seedream 5.0. A trilha foi gerada pela ACE-Step no EmpirioLabs.

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.
• Decomposição em camadas. Divida uma imagem em uma imagem base mais até 16 camadas PNG transparentes, cada uma retornada com sua posição na imagem base, um nome e uma descrição.
• Fundos transparentes. Edite uma imagem que já tenha um canal alfa e mantenha a transparência no resultado.
• Texto na imagem. Placas, etiquetas e cartazes são exibidos em chinês, inglês e outros 14 idiomas, incluindo japonês, coreano, árabe, espanhol e francês.

A saída é PNG ou JPEG em níveis de resolução 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-0-flash", "prompt": "Um festival de lanternas de papel sobre um rio ao entardecer, reflexos na água", "aspect_ratio": "16:9", "qualidade": "2K", "sincronização": verdadeiro }'

Sincroniza e assíncrono. Com "sincronização": Verdadeiro A solicitação permanece aberta e retorna a imagem finalizada Dados. Sem ele, a resposta é um trabalho com um job id e a poll url. Enquete VAI /v1/jobs/<job_id> até 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-0-flash", prompt="Um festival de lanternas de papel sobre um rio ao entardecer, reflexos na água", extra_body={"sync": True, "aspect_ratio": "16:9", "quality": "2K"},) print(result.data[0].url)

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:

{ "model": "seedream-5-0-flash", "prompt": "Coloque o copo da imagem 1 sobre a mesa da imagem 2, mantendo a iluminação da imagem 2", "imagem": [ "https://example.com/cup.png", "https://example.com/table.jpg" ], "sync": true }

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-0-flash", "prompt": "Adicione um pequeno vaso de vidro com uma única tulipa branca dentro <bbox>de 60 80 300 520</bbox>. Mantenha todo o resto inalterado.", "imagem": "https://example.com/kitchen.png", "sync": true }

Tags também funcionam entre imagens, por exemplo, para posicionar o sujeito de uma região da imagem 1 em uma região da imagem 2.

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.

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-0-flash", "layer_decomposition": true, "image": "https://example.com/perfume-ad.png", "prompt": "Separe o frasco de perfume, seu rótulo e o feixe de luz", "sync": true }'

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 descrição:

{ "url": "https://media.empiriolabs.ai/...", "z_index": 4, "width": 476, "height": 1024, "bounding_box": { "absoluto": [1181, 268, 1657, 1292], "normalizado": [419, 169, 588, 815] }, "nome": "Corpo principal do frasco de perfume", "descrição": "Um frasco quadrado transparente com tampa facetada de ouro..." }

Empilhe as camadas sobre a imagem base em ascendente z_index para reconstruí-lo, ou mover, redimensionar, recolorir ou substituir qualquer camada primeiro. Uma camada também pode ser a entrada para uma nova solicitação, por exemplo, para recolorir um elemento e manter sua transparência.

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.
• Escale cada camada para sua caixa. Uma camada PNG nem sempre tem o tamanho de sua pegada na imagem base, e uma camada de texto pode voltar várias vezes maior. Escale cada camada para a largura e altura de sua bounding_box.absoluto antes de colocá-la no canto superior esquerdo da caixa.
• O prompt decide quantas camadas voltam. Sem um prompt, o modelo separa cada elemento encontrado, e cada imagem retornada fatura. Nomeie os elementos que você precisa ou indique suas regiões como <bbox> tags, para manter o resultado só nesses.
• Retente uma decomposição em camadas que não pôde ser processada. Uma decomposição em camadas ocasionalmente falha com um erro dizendo que o conteúdo da imagem não pôde ser processado. Envie a mesma solicitação novamente.
• Não há otimização rápida de prompts. prompt_optimization_mode: "rápido" do Seedream 5.0 Pro retorna um erro no Flash. Deixe o controle de fora.
• Um resultado transparente precisa de uma entrada transparente. Contexto: "Transparente" trabalha em uma edição de exatamente uma imagem que já possui um canal alfa, como uma camada de uma decomposição, com output_format definir para png. A saída do JPEG retorna um erro.

Preços

Por imagem. O Flash do Seedream 5.0 é pago conforme você vai e faturado por imagem devolvida, a uma única taxa para cada nível de resolução. Imagens de referência não cobram nada. Uma decomposição de camada cobra cada imagem que ela retorna, a imagem base e cada camada, na mesma taxa. Não é necessária assinatura. As tarifas 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 o Seedream 5.0 Flash 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 o nível Pro da mesma família, veja Como usar a API do Seedream 5.0 Pro.

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