Resposta rápida
- Chame a API assíncrona de tarefas de imagem com model=doubao-seedream-5-5.
- size aceita os níveis 1K/1.5K/2K ou pixels explícitos LxA com total de 921.600-4.624.220 pixels.
- metadata.background=transparent retorna PNG RGBA. Nas camadas, max_images limita o total de saídas incluindo a base: 2-100, padrão 30.
Parâmetros principais
- model | string | obrigatório | doubao-seedream-5-5 | - | Use doubao-seedream-5-5 como identificador exato do modelo.
- prompt | string | opcional | - | - | Obrigatório para gerar e editar; opcional quando layer_decomposition=true.
- size | string | opcional | - | 1K | 1.5K | 2K | WIDTHxHEIGHT | Na geração usa o padrão do modelo e auto nas camadas. Os níveis não fixam a proporção; as dimensões explícitas devem totalizar 921.600-4.624.220 pixels.
- image_urls | string[] | opcional | - | 0-10 | Forneça de 1 a 10 imagens de referência JPEG, PNG ou WEBP via image_urls. Envie primeiro os arquivos locais e depois use as URLs retornadas.
- n | integer | opcional | 1 | 1 | Use 1 ou omita. A geração comum retorna uma imagem; este campo não define o número de camadas.
- layer_decomposition | boolean | opcional | false | - | Deixe desativado na geração comum. Exige exatamente uma referência e sem metadata.background. Retorna uma base e camadas PNG transparentes; layer_decomposition_options.max_images limita o total de saídas.
- layer_decomposition_options.max_images | integer | opcional | 30 | 2-100 | Limite total de saídas da decomposição em camadas, incluindo a base. Não é uma quantidade garantida; o modelo decide quantas saídas são necessárias.
- layer_decomposition_options.text_recognition | boolean | opcional | - | - | Controla o reconhecimento de texto durante a decomposição em camadas. Os resultados da tarefa só incluem os metadados text_recognition quando o provedor os retorna.
- metadata.output_format | string | opcional | - | png | jpeg | Se omitido, usa o padrão do provedor; com transparência seleciona png. Nas camadas afeta apenas a imagem base; as demais camadas são sempre PNG.
- metadata.background | string | opcional | - | auto | opaque | transparent | Apenas para geração e edição. Omita quando layer_decomposition=true, mesmo com opaque. transparent retorna PNG RGBA e não aceita jpeg.
- metadata.watermark | boolean | opcional | - | - | Defina false para desativar a marca d'água visível.
- metadata.response_format | string | opcional | url | url | b64_json | Forma de entrega do resultado; recomenda-se url.
Erros comuns
- 400 invalid_input: gatilho=Pixels de size fora do intervalo, mais de 10 imagens de referência, ou layer_decomposition sem exatamente uma imagem de entrada.; correção=Valide size, a quantidade de image_urls e as restrições de entrada de layer_decomposition conforme a documentação.; nova tentativa=Tente novamente apenas após corrigir o payload.
- 429 rate_limit_exceeded: gatilho=A taxa de requisições, a concorrência ou a cota atingem o limite de taxa.; correção=Aplique backoff exponencial e depois revise o ritmo das requisições e o uso da cota.; nova tentativa=Use backoff de 1s/2s/4s com jitter.










