Seedream

​

1. Visão geral

​

Modelos suportados

​

2. Endpoint e autenticação

POST https://{api_domain}/v3/bytedance/api/v3/images/generations

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

​

3. Parâmetros da requisição

​

3.1 Parâmetros gerais

​

3.2 Parâmetros específicos do modelo

​

3.3 Exemplo de geração a partir de texto

curl -sS -X POST "https://{api_domain}/v3/bytedance/api/v3/images/generations" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dola-seedream-5-0-pro-260628",
    "prompt": "Um golden retriever com um lenço vermelho, sob a luz natural à beira de um lago nevado, fotografia cinematográfica",
    "size": "2K",
    "response_format": "url",
    "output_format": "jpeg",
    "watermark": true
  }'

​

3.4 Exemplo de geração a partir de imagem

{
  "model": "seedream-4-5-251128",
  "prompt": "Coloque a pessoa e as roupas da imagem de referência em uma mesma cena noturna urbana, mantendo as características da pessoa consistentes",
  "image": [
    "https://example.com/person.png",
    "https://example.com/outfit.png"
  ],
  "size": "2560x1440",
  "response_format": "url"
}

​

3.5 Exemplo de conjunto de imagens (apenas 4.0, 4.5 e 5.0 Lite)

{
  "model": "seedream-5-0-260128",
  "prompt": "Gere três pôsteres das quatro estações com um estilo unificado",
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": {
    "max_images": 3
  },
  "response_format": "url"
}

​

4. Resposta

{
  "created": 1786000000,
  "model": "seedream-4-5-251128",
  "data": [
    {
      "url": "https://example.com/generated-image.jpeg",
      "size": "2560x1440",
      "output_format": "jpeg"
    }
  ],
  "usage": {
    "generated_images": 1,
    "input_images": 0
  }
}

• Quando response_format=url, retorna data[].url; quando response_format=b64_json, retorna data[].b64_json.
• Seedream 4.0, 4.5 e 5.0 Lite podem retornar múltiplos itens em data no modo de conjunto de imagens.
• Seedream 5.0 Pro retorna um item em data no cenário de geração de imagem; com a decomposição em camadas ativada, retorna múltiplos itens em data (uma imagem base + várias camadas), cada um incluindo adicionalmente a ordem de empilhamento das camadas z_index (0 para a imagem base), o nome name, a descrição description e a caixa delimitadora bounding_box (com coordenadas absolute / normalized; a imagem base não retorna esse campo).
• model retorna o ID do modelo do cliente usado nesta requisição.
• A validade da URL da imagem é determinada pela plataforma e pelos serviços upstream; baixe e salve as imagens imediatamente após o retorno.

​

5. Limitações dos modelos

​

Seedream 4.0 / 4.5 / 5.0 Lite

• Suporta geração a partir de texto, geração a partir de imagem e geração de conjuntos de imagens.
• Conjuntos de imagens usam sequential_image_generation e seus campos de opções.
• A quantidade de imagens de entrada, o tamanho, a resolução e a proporção das imagens seguem a documentação upstream do modelo correspondente. Seedream 4.0 e 4.5 geram saída fixa em JPEG e não suportam o parâmetro de requisição output_format; Seedream 5.0 Lite suporta jpeg e png.

​

Seedream 5.0 Pro

• Suporta geração a partir de texto, geração a partir de uma única imagem e fusão de múltiplas imagens.
• No cenário de geração de imagem, retorna uma imagem bem-sucedida. Com a decomposição em camadas ativada (layer_decomposition: true), retorna uma imagem base e várias camadas (até 16 camadas), caso em que data contém múltiplos itens. Não suporta geração de conjunto de imagens (sequential_image_generation).
• Não suporta sequential_image_generation e sequential_image_generation_options.
• size aceita 1K, 1.5K, 2K ou larguraxaltura explícito.
• Ao especificar largura e altura explicitamente, a proporção e o total de pixels devem atender às limitações do modelo; as dimensões reais da imagem de saída seguem data[].size na resposta.
• Suporta decomposição em camadas: ao definir layer_decomposition: true, uma única imagem de entrada é decomposta em uma imagem base e até 16 camadas editáveis independentemente (cada camada é um PNG com canal alpha). Nesse cenário, image é obrigatório e só pode conter uma imagem; enviar várias resulta em erro. A decomposição em camadas é tudo ou nada: se qualquer camada falhar, toda a requisição falha; sucesso parcial não é suportado.
• Regras de size na decomposição em camadas: a resolução da imagem base é igual a size; a resolução de cada camada fica próxima de size, mas cada camada mantém a proporção da região correspondente na imagem original, por isso os pixels reais de cada camada diferem. Isso significa que as imagens de saída de uma mesma requisição podem cair em faixas de preço por pixel diferentes. size aceita 1K, 1.5K, 2K e auto, com auto como padrão.

​

6. Cobrança e uso

• 4.0, 4.5 e 5.0 Lite são cobrados pelo número de imagens geradas com sucesso; na geração de conjuntos de imagens, a cobrança considera a quantidade realmente gerada com sucesso.
• 5.0 Pro é cobrado pelas imagens de saída bem-sucedidas; com múltiplas imagens de entrada, a primeira imagem de referência é gratuita e as imagens de referência adicionais são medidas separadamente; tamanhos de saída diferentes correspondem a faixas de preço diferentes. Com a decomposição em camadas ativada, a imagem base e cada camada contam como uma imagem de saída bem-sucedida, cada uma faturada separadamente na faixa de preço correspondente aos pixels do seu data[].size (por exemplo, a imagem base em uma faixa de alta resolução e algumas camadas em faixas de baixa resolução); a fatura final é a soma das quantidades de cada faixa.
• A unidade de uso é “imagem” ou item.
• Os preços específicos devem ser confirmados na página de preços do produto da sua plataforma.

​

7. Solução de problemas