Seedream 5.5

Use o modelo doubao-seedream-5-5-261028 com POST https://apimaster.ai/v1/images/generations, um corpo JSON e Authorization: Bearer YOUR_API_KEY. Crie sua chave APIMaster no console.

Oferece suporte a texto para imagem, edição com até dez referências, edição sucessiva, saída RGBA transparente nativa, decomposição em camadas e OCR de rich text. A geração normal retorna uma imagem. A decomposição retorna uma base e camadas separadas. Não há suporte a streaming, geração sequencial de imagens e pesquisa na web. Use o endpoint síncrono; aguarde pelo menos 300 segundos antes de um timeout do cliente e evite reenvios cegos.

Preço base oficial

Verificado em relação aos preços da Volcengine em 2026-11-13. A conversão configurada era de 7 CNY por USD.

Item	CNY por imagem	Preço base aproximado em USD
Cada referência de entrada, incluindo a primeira	0.05	0.00714286
Saída com largura × altura ≤ 2,610,000 pixels	0.13	0.01857143
Saída acima de 2,610,000 pixels	0.23	0.03285714

Geração e decomposição usam as mesmas tarifas de saída. Cada base/camada é cobrada separadamente usando seu data[].size real; o lado mais longo não determina a faixa. 2048x1024 está na faixa inferior. Duas entradas mais uma saída de faixa alta custam CNY 0.33 antes dos multiplicadores de conta/canal. Diferentemente do Seedream 5.0 Pro, a primeira referência não é gratuita. As cobranças reais da conta incluem coeficientes aplicáveis de canal/grupo de usuários e arredondamento de cota para inteiro. Consulte o model card atualizado e os logs de uso.

Texto para imagem

curl --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"doubao-seedream-5-5-261028",
    "prompt":"A cream landscape poster, a red circle, a blue square, heading HELLO SEEDREAM",
    "size":"1.5K",
    "output_format":"png",
    "background":"opaque",
    "response_format":"url",
    "watermark":false
  }'

Parâmetros

Campo	Tipo / padrão	Regras
model	string obrigatório	doubao-seedream-5-5-261028.
prompt	string	Obrigatório para geração; opcional para decomposição. Descreva o conteúdo, o estilo, a proporção, o texto ou o local da edição. A orientação oficial de escrita recomenda ≤300 caracteres chineses ou ≤600 palavras em inglês; isto é uma orientação, não um limite de bytes.
image	string ou string[]	URL pública ou data:image/png;base64,.... Até dez referências de geração; exatamente uma entrada para decomposição. Caminhos do sistema de arquivos local não funcionam.
size	string	Para geração, o padrão é 2K; 1K, 1.5K, 2K ou WIDTHxHEIGHT exato. Para decomposição, o padrão é auto, aceita apenas auto e essas três faixas.
output_format	string, png	png ou jpeg. Para decomposição, isto controla apenas a base; as camadas são sempre PNG.
background	string, auto	auto, transparent ou opaque, somente para geração. Saída transparente exige PNG; omita este campo totalmente para decomposição.
response_format	string, url	url ou b64_json. Leia o campo correspondente em cada item data[].
watermark	boolean, true	Defina false para omitir a marca d'água visível de geração por IA.
optimize_prompt_options	object	Apenas {"mode":"standard"} é suportado por 5.5; fast não é suportado.
layer_decomposition	boolean, false	Habilite a decomposição de uma imagem PNG/JPEG.
layer_decomposition_options	object	Opções de decomposição abaixo.
layer_decomposition_options.max_images	integer, 30	2–100, incluindo a base. Um máximo, não uma contagem garantida.
layer_decomposition_options.text_recognition	boolean, false	Solicite OCR de rich text para camadas de texto regular.
safety_identifier	string	Identificador de usuário estável em inglês, com no máximo 64 caracteres; use um hash em vez de informações pessoais de contato.

Não use resolution, quality, n ou seed de outro modelo para controlar este modelo. Eles não estão listados como os controles de geração correspondentes a ele na API oficial. Defina os limites de decomposição com layer_decomposition_options.max_images.

Tamanhos e restrições de entrada

Para geração comum, escolha uma faixa (1K, 1.5K, 2K) e descreva a proporção no prompt, ou forneça dimensões exatas. A área exata de saída deve ser de 921,600–4,624,220 pixels, com proporção 1:16–16:1, satisfazendo ambas as restrições. 2880x1440 é válido; 512x512 é pequeno demais. Não existe faixa 4K.

A decomposição não aceita dimensões exatas. Com auto, os tamanhos de base/camada dentro do intervalo suportado mantêm suas dimensões originais quando possível; itens menores/maiores são escalados em direção a 1K/2K preservando sua proporção. As camadas retornadas podem ocupar faixas de cobrança diferentes.

Restrição de entrada	Geração/edição	Decomposição
Quantidade	Até 10	Exatamente 1
Formatos	JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF	PNG, JPEG
Tamanho do arquivo por imagem	≤30 MB	≤30 MB
Área em pixels	196–36,000,000; ambos os lados >14 px	262,144–36,000,000
Proporção	1:16–16:1	1:16–16:1

Use tipos MIME em minúsculas em URLs de dados. URLs de entrada remotas devem ser acessíveis ao serviço.

Edição e imagens transparentes

{
  "model":"doubao-seedream-5-5-261028",
  "prompt":"Keep the layout of the first image; recolor only its circle using the second reference",
  "image":["https://example.com/source.png","https://example.com/reference.png"],
  "size":"1.5K",
  "output_format":"png",
  "watermark":false
}

Para uma entrada, image pode ser uma string. Para edições sucessivas, passe explicitamente a saída anterior como a próxima entrada: isto não é uma conversa com estado, e cada solicitação é cobrada separadamente. Descreva coordenadas/caixas/setas no prompt ou desenhe marcações na referência; não há um parâmetro de posicionamento mask documentado separadamente para esta interface.

Para geração transparente nativa, omita image se desnecessário e defina background: "transparent", output_format: "png", com um prompt como “a translucent blue glass butterfly, isolated asset, transparent background”. A edição pode usar até dez referências; elas não precisam já ter canais alfa. transparent mais jpeg é inválido. O background de uma resposta descreve a transparência real (transparent ou opaque).

Decomposição e OCR de rich text

{
  "model":"doubao-seedream-5-5-261028",
  "image":"https://example.com/poster.png",
  "prompt":"Separate the heading, circle and square into editable layers",
  "layer_decomposition":true,
  "layer_decomposition_options":{"max_images":4,"text_recognition":true},
  "size":"auto",
  "output_format":"png",
  "watermark":false
}

Oferece suporte a uma base mais até 99 camadas. max_images: 4 inclui a base. Omita background; toda camada é PNG transparente. A falha de uma camada individual faz a solicitação inteira falhar em vez de retornar sucesso parcial.

Leia todas as entradas data[]:

• url/b64_json, size e output_format identificam o artefato e suas dimensões reais; background está disponível quando aplicável.
• z_index: 0 identifica a base; índices maiores aparecem acima dos menores.
• name e description descrevem a camada.
• bounding_box.absolute é [left,top,right,bottom] em pixels da base de saída. Redimensione uma camada para (right-left) × (bottom-top) e posicione-a em (left,top); as dimensões do arquivo da camada podem diferir de sua área ocupada no canvas.
• bounding_box.normalized usa coordenadas 0–1000. Multiplique as coordenadas horizontais/verticais pela largura/altura do canvas de destino e divida por 1000.
• text_recognition aparece apenas quando solicitado e a camada contém texto regular reconhecido. Caligrafia, letras artísticas e camadas sem texto podem omiti-lo.

O OCR contém text e lines[]; cada linha tem seu próprio bounding_box e runs[] estilizado. Cada trecho tem text e style, que podem conter similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow e translucent. Estas são interpretações visuais aproximadas, não propriedades exatas do design original; o reconhecimento de fonte pode retornar unknown.

Resposta, armazenamento e falhas

A resposta contém created, model, data[], usage.input_images e usage.generated_images. A contagem gerada inclui base e camadas. Preserve os metadados completos da resposta. As URLs de download originais do provedor expiram após 24 horas; baixe/arquive seus ativos prontamente.

Corrija dimensões inválidas, contagens de referência ou opções de transparência incompatíveis antes de tentar novamente. Trate autenticação, permissões, moderação, limites de taxa e falhas upstream separadamente; nunca interprete um erro como uma geração bem-sucedida. Os limites de IPM contam imagens geradas por conta/versão do modelo; a decomposição reserva max_images e devolve a capacidade não utilizada após a conclusão, enquanto a cobrança usa as imagens realmente produzidas.

Fontes oficiais: Seedream 5.5, API de geração de imagens, preços. Parâmetros verificados em 2026-11-13.