Skip to main content
POST

Autorização

string
obrigatório
Todos os endpoints da API exigem autenticação por Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione-a ao cabeçalho da requisição:

Corpo da requisição

string
padrão:"seedream-5-0-lite"
obrigatório
Nome do modelo de geração de imagensModelos suportados: seedream-5-0-lite, seedream-5.0-lite, Seedream-5.0-liteExemplo: "seedream-5-0-lite"
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de imagem.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Descrição textual para a geração da imagem
string
padrão:"1:1"
Proporção da imagemProporções suportadas:
  • 1:1 - Quadrado (padrão)
  • 4:3 - Paisagem 4:3
  • 3:4 - Retrato 3:4
  • 16:9 - Paisagem widescreen
  • 9:16 - Retrato vertical
  • 3:2 - Paisagem 3:2
  • 2:3 - Retrato 2:3
  • 2:1 - Formato horizontal alongado
  • 1:2 - Formato vertical alongado
  • 21:9 - Ultra-wide
  • auto - Ajusta automaticamente a proporção pela imagem de referência (requer image_urls)
2x1 equivale a 2:1 e 1x2 equivale a 1:2. O x deve ser minúsculo e espaços não são aceitos.
Observação: o Seedream-5.0-Lite não suporta a proporção 9:21
string
padrão:"2K"
Resolução da imagemResoluções suportadas:
  • 2K - Resolução padrão (padrão)
  • 3K - Alta definição
  • 4K - Ultra alta definição
Observação: o Seedream-5.0-Lite suporta resoluções 2K, 3K e 4K, e não suporta 1K
Tamanhos de referência para as resoluções:
integer
Número de imagens a serem geradasIntervalo: 1–15Padrão: 1Observação:
  • Quando n > 1, o modo de geração sequencial é ativado automaticamente
  • É necessário informar um número puro (ex.: 1), não use aspas, caso contrário ocorrerá um erro
A cobrança será deduzida antecipadamente com base na quantidade
A quantidade de imagens de referência em image_urls + a quantidade final de imagens geradas especificada por n deve ser ≤ 15.
array
Lista de URLs de imagens de referência para geração image-to-imageDois formatos são suportados:1. URL completa da imagem
  • URL de imagem publicamente acessível (http:// ou https://)
  • Exemplo: https://example.com/image.jpg
2. Formato codificado em Base64
  • É obrigatório usar o formato Data URI completo
  • Formato: data:image/{format};base64,{base64data}
  • Formatos de imagem suportados: jpeg, png
  • Exemplo: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • Atenção: o prefixo data:image/jpeg;base64, é obrigatório
Limitações:
  • Formatos de imagem: jpeg, png
  • Intervalo de proporção (largura/altura): [1/3, 3]
  • Largura e altura (px) > 14
  • Tamanho: não exceder 10MB por imagem
  • Total de pixels: não exceder 6000×6000 px
A quantidade de imagens de referência em image_urls + a quantidade final de imagens geradas especificada por n deve ser ≤ 15.
string
padrão:"jpeg"
Formato de saída da imagem
  • jpeg: formato JPEG (padrão)
  • png: formato PNG, adequado para fundos transparentes e casos de uso similares
Observação: o parâmetro output_format é exclusivo do Seedream-5.0-Lite. Outros modelos de imagem ignorarão esse parâmetro.
string
padrão:"disabled"
Modo de geração sequencial de imagensControla se múltiplas imagens devem ser geradas:
  • disabled: desativa o modo sequencial (padrão)
  • auto: ativa o modo sequencial, permite gerar múltiplas imagens
Notas de uso:
  • Quando n > 1, o modo será automaticamente definido como auto
object
Opções de geração sequencial de imagensDisponível quando sequential_image_generation está definido como autoPropriedades:
  • max_images (integer): define o número de imagens a serem geradas
Exemplo:
boolean
padrão:"false"
Define se uma marca d’água deve ser adicionada à imagem gerada
  • true: adicionar marca d’água
  • false: sem marca d’água (padrão)

Resposta

integer
Código de status da resposta
array
Array de dados da resposta