Seedream 5.0 Pro

Seedream 5.0 Pro é o modelo de imagens da ByteDance. Uma requisição gera uma imagem a partir de um prompt, de um prompt com até 10 imagens de referência, ou separa uma imagem em uma imagem de base e até 16 camadas transparentes. Envie a requisição, guarde o ID da tarefa retornado e leia as imagens prontas na tarefa. As imagens de referência são enviadas como URLs.

IDs dos modelos

Veja os preços atuais na página do modelo.

Exemplo rápido

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "size": "1K",
    "watermark": false
  }'

Endpoint

POST https://api.seedrouter.ai/v1/images/generations

A resposta é uma tarefa ({"id": "task_...", "status": "processing"}), não a imagem pronta. Consulte GET /v1/tasks/{task_id} para obter o resultado. Mantenha as chaves de API no código do servidor. As referências e a decomposição em camadas vão na mesma requisição por image; /v1/images/edits não é usado para este modelo e retorna 400.

Parâmetros

Campos fora desta lista são descartados antes de encaminhar a requisição; nunca causam erros nem alteram a saída. n, stream, seed, response_format e geração sequencial não estão disponíveis. callback_url não está disponível; consulte a tarefa.

Tamanho de saída

A faixa define a escala e o prompt define o formato. Indique a proporção em prompt (por exemplo, “um formato horizontal 16:9”) e o modelo escolhe o enquadramento:

Para um quadro fixo, envie dimensões exatas em pixels em vez de uma faixa. 1K e 1.5K custam o mesmo; 2K e qualquer tamanho acima de 2,61 milhões de pixels custam mais (veja Dimensões de preço).

Imagens de referência

Passe uma imagem para editá-la, ou 2–10 para combiná-las, e diga em prompt o que manter e o que mudar. Faça referência a elas pela ordem (“a jaqueta da imagem 1”).

{
  "model": "seedream-5-0-pro",
  "prompt": "Put the jacket from image 1 on the model from image 2, standing on a rainy street at night.",
  "image": ["https://example.com/jacket.png", "https://example.com/model.jpg"],
  "size": "1.5K"
}

Decomposição em camadas

Envie exatamente uma imagem com layer_decomposition: true. A tarefa retorna primeiro a imagem de base e depois cada camada como PNG transparente.

{
  "model": "seedream-5-0-pro",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "prompt": "Separate the headline, the product and the background."
}

Cada camada inclui z_index (a imagem de base é 0; números maiores ficam por cima), name, description e bounding_box. bounding_box.absolute é [left, top, right, bottom] em pixels da imagem de base; bounding_box.normalized é a mesma caixa em milésimos da largura e da altura da imagem de base. Para reconstruir a imagem, redimensione cada camada para sua caixa e coloque-a sobre a imagem de base em ordem crescente de z_index.

Com size: "auto", a imagem de base e cada camada mantêm seu tamanho na imagem de entrada. A entrada deve ser PNG ou JPEG com total de pixels (largura × altura) entre 262.144 (512 × 512) e 36.000.000 (6000 × 6000).

Fundo transparente

Envie um PNG com canal alfa e background: "transparent" para obter um PNG com fundo transparente:

{
  "model": "seedream-5-0-pro",
  "prompt": "Turn this sticker into a glossy enamel pin, keep the outline.",
  "image": "https://example.com/sticker.png",
  "background": "transparent",
  "output_format": "png"
}

Entradas de mídia

Cada referência é uma URL pública HTTP(S). URIs de dados Base64 não são aceitas: envie o arquivo para seu próprio armazenamento e passe a URL. Os formatos aceitos são JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF, até 30 MB cada, com proporção entre 1:16 e 16:1, largura e altura maiores que 14 pixels e no máximo 36.000.000 pixels no total. A decomposição em camadas aceita apenas PNG ou JPEG.

Dimensões de preço

Veja as tarifas atuais na seção de preços do modelo. Seedream 5.0 Pro é cobrado por imagem de saída conforme o cenário e a faixa de pixels, mais cada imagem de referência após a primeira:

generation:          cost = image price for its tier + extra references × reference price
layer decomposition: cost = images returned × per-image price for the request's tier

• A faixa inferior cobre imagens de até 2,61 milhões de pixels (1.5K e menores); qualquer tamanho maior fica na faixa superior.
• A decomposição em camadas cobra a imagem de base e cada camada. Toda a requisição usa uma única faixa: o preço menor só se aplica quando todas as imagens retornadas ficam dentro de 2,61 milhões de pixels.
• O valor reservado quando uma tarefa é aceita cobre o maior resultado: uma imagem na faixa solicitada ou 17 imagens para decomposição em camadas (auto conta como faixa superior). Depois, a tarefa é cobrada pelas imagens realmente retornadas e a diferença é liberada.

Veja as cobranças finais no histórico de uso da conta. Tarefas que falham não são cobradas.

Esquema de saída

O envio retorna a tarefa:

{"id": "task_...", "model": "seedream-5-0-pro", "status": "processing", "created_at": 1789689600}

Consultar a tarefa

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Consulte a cada 10–20 segundos até status ser completed ou failed. Um timeout de rede durante a consulta não significa que a geração falhou: guarde o ID da tarefa e retome as consultas. Não crie outra tarefa para verificar o progresso.

Tarefa concluída

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689653,
  "output": {
    "created": 1789689650,
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg",
        "size": "1024x1024",
        "output_format": "jpeg"
      }
    ],
    "usage": { "output_tokens": 4096, "total_tokens": 4096 }
  }
}

Uma tarefa de decomposição em camadas lista a imagem de base e depois cada camada:

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg", "size": "832x1248", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "527x1044",
      "output_format": "png",
      "z_index": 1,
      "name": "Ceramic coffee cup",
      "description": "White ceramic cup with a matte glaze, extracted without the table.",
      "bounding_box": { "absolute": [212, 418, 610, 1206], "normalized": [255, 335, 733, 966] }
    }
  ]
}

Nos nossos testes, uma imagem 1K levou cerca de 35–55 segundos, e uma decomposição em camadas em 1K que retornou uma imagem de base e 13 camadas levou cerca de 140 segundos.

Erros

Requisições rejeitadas antes de criar uma tarefa retornam um erro HTTP com um objeto error e não são cobradas. Uma tarefa que falha após a aceitação retorna HTTP 200 quando consultada, com status: "failed" e um objeto error.

Veja o catálogo compartilhado de erros para códigos, status HTTP e orientações de nova tentativa.

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Se o próprio envio atingir o tempo limite, consulte suas tarefas antes de enviar novamente: a primeira requisição pode ter sido aceita.

Dicas

• Comece em 1K ou 1.5K para fazer testes; 1.5K custa o mesmo que 1K.
• Indique o formato no prompt ao usar uma faixa ou envie dimensões exatas em pixels para um layout fixo.
• Com várias referências, diga o que cada uma contribui e faça referência a elas pela ordem.
• Use watermark: false quando precisar de uma imagem sem marca; o padrão adiciona uma.
• Para a decomposição em camadas, liste os elementos que quer separar para manter a quantidade de camadas baixa.

Relacionados

• Playground e preços de Seedream 5.0 Pro
• Baixar OpenAPI
• Markdown para copiar