img_uuid e, em seguida, faça o polling ou use um callback HTTPS para a imagem gerada única.API Seedream 5 Pro para Geração de Imagens
Acesse o Seedream 5.0 Pro através da API Aberta independente da GoEnhance. Envie um prompt de texto ou adicione até 10 imagens de referência, receba um
Criar uma Chave de API
Escolha um Modo de Solicitação do Seedream 5 Pro
Texto para Imagem
Envie o prompt necessário e omita a image_list para uma geração pura de texto para imagem.
Geração Guiada por Referência
Adicione de 1 a 10 URLs de imagens públicas na image_list. Cada imagem de referência adiciona 0,15 token, equivalente a $0.003.
Valide a solicitação antes do envio e acompanhe o resultado como uma tarefa de imagem assíncrona.
Capacidades e Limites da API Seedream 5 Pro
Validação de prompt
O <code>prompt</code> é obrigatório e aceita de 1 a 2.000 caracteres.
Oito proporções de aspecto
Defina o <code>ratio</code> como <code>1:1</code>, <code>4:3</code>, <code>3:4</code>, <code>16:9</code>, <code>9:16</code>, <code>3:2</code>, <code>2:3</code> ou <code>21:9</code>. Omita-o para deixar o modelo escolher a partir do prompt.
Saída 1K ou 2K
Defina o <code>image_size</code> como <code>1K</code> ou <code>2K</code>. O padrão documentado é <code>2K</code>.
Até 10 referências
Passe de 1 a 10 objetos de URL na <code>image_list</code> para orientação de imagem para imagem, ou omita o campo para texto para imagem.
Uma imagem por tarefa
O Seedream 5.0 Pro retorna uma única imagem gerada e não suporta a geração sequencial de imagens agrupadas nesta rota.
Conclusão por polling ou callback
Salve o <code>img_uuid</code> retornado, depois faça o polling dos detalhes da tarefa ou receba alterações de status em uma URL de callback HTTPS pública.
O GoEnhance precifica o nível de saída e adiciona uma pequena taxa para cada imagem de referência.
Preços da API do Seedream 5 Pro
1K: $0.045 por imagem
Uma saída 1K custa 2,25 tokens, documentado como $0.045 para uma imagem gerada.
2K: $0.09 por imagem
Uma saída 2K custa 4,5 tokens, documentado como $0.09 para uma imagem gerada.
Referências: $0.003 cada
Cada URL na <code>image_list</code> adiciona 0,15 token, equivalente a $0.003. Verifique os preços em tempo real da GoEnhance antes de lotes de produção, pois os termos da plataforma podem mudar.
Integre a API do Seedream 5 Pro
1
1. Crie e proteja uma chave de API
Crie uma chave em /keys, envie-a como autorização bearer e mantenha-a fora do código do navegador e de logs públicos.
2
2. Construa a solicitação
Adicione o prompt necessário, escolha
1K ou 2K e, opcionalmente, defina uma proporção de aspecto suportada. 3
3. Adicione referências apenas quando necessário
Inclua
image_list com 1 a 10 URLs de imagem acessíveis para orientação de referência; omita-o para texto para imagem. 4
4. Envie e persista o img_uuid
Faça um POST para
https://api.goenhance.ai/api/v1/seedream-5-pro e armazene o img_uuid retornado com seu registro de trabalho interno. 5
5. Faça polling ou receba callbacks
Faça polling em
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=..., ou forneça uma custom_callback_url para notificações de status via HTTPS. 6
6. Trate resultados terminais de forma idempotente
Verifique o status HTTP mais o
code/msg da resposta, corrija solicitações inválidas antes de tentar novamente e evite processamento duplicado a jusante.Conecte geração de prompt, referências, rastreamento assíncrono, armazenamento e revisão em um único pipeline de imagem.
O que os desenvolvedores constroem com o Seedream 5 Pro
Visuais de campanha de produto
Gere conceitos originais de cenários de produtos a partir de prompts estruturados para revisão e produção de campanhas.
Direção de arte guiada por referência
Use referências visuais aprovadas para orientar um novo resultado de imagem única, mantendo o gerenciamento de tarefas consistente.
Variantes criativas localizadas
Adapte detalhes de prompts para mercados e formatos enquanto preserva um fluxo de trabalho compartilhado de solicitação e revisão.
Pipelines de ilustração editorial
Crie imagens 1K ou 2K para artes de artigos, capas e conceitos de campanha.
Arte conceitual e pré-visualização
Gere ambientes, objetos e estudos de atmosfera para decisões criativas iniciais.
Filas de ativos automatizadas
Conecte envio, persistência de trabalho, polling ou callbacks, armazenamento e aprovação humana em um serviço de backend.
Preços, campos de solicitação, imagens de referência, comportamento de saída e relacionamento com a plataforma.