Qualidade de imagem flagship
Seedream 5 Pro renderiza cenas fotorrealistas, packshots editoriais e texto preciso em imagem em 1K ou 2K — no nível de GPT Image e NanoBanana.
Guia da API Seedream 5 Pro
Seedream 5 Pro é o modelo de imagem flagship da ByteDance — forte renderização de texto multilíngue, edição multi-referência e saída fotorrealista limpa. Na Seedance API, você o chama como um alias estável com endpoints REST simples, polling assíncrono e preço por imagem.
Saída 1K ou 2K
1:1 a 16:9, 9:16, 2:3, 3:2
Prompt ou até 10 imagens de referência
JSON sobre HTTPS
Requisição inicial
curl -X POST 'https://seedanceapi.org/v1/images/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedream-5-pro",
"prompt": "Studio product shot of a matte black water bottle on wet stone, soft top light",
"aspect_ratio": "4:3",
"resolution": "2k",
"image_urls": []
}'POST /v1/images/generations retorna um task_id. Faça polling em GET /v1/images/generations/:task_id até status ser SUCCESS e leia images[].url.
Equipes escolhem a API Seedream 5 Pro quando precisam de qualidade de imagem flagship atrás de uma superfície REST previsível — sem SDK de provedor nem mudanças de esquema surpresa.
Seedream 5 Pro renderiza cenas fotorrealistas, packshots editoriais e texto preciso em imagem em 1K ou 2K — no nível de GPT Image e NanoBanana.
Você chama model "seedream-5-pro". Roteamento, capacidade e fallbacks ficam do nosso lado — sua integração não sofre mudanças upstream.
9 créditos por imagem 1K, 18 por 2K, mais 0,8 por imagem de referência a partir da segunda. estimated_credits retorna em toda resposta de criação.
A superfície pública expõe o que o modelo realmente faz: texto-para-imagem e edição guiada por referências com até dez imagens.
Envie um prompt de até 3000 caracteres com proporção e resolução — o modelo cuida de composição, luz e tipografia na imagem.
Passe 1–10 URLs HTTPS públicas em image_urls para editar, compor ou reestilizar visuais existentes — troca de produto, fundo, transferência de estilo.
Defina resolution como "2k" para renders com qualidade de impressão e assets finais. 1K cobre previews e iterações.
Um dos maiores pontos fortes — texto legível em inglês, chinês, japonês e mais dentro de pôsteres e letreiros.
A criação retorna task_id na hora. Faça polling do status no seu ritmo e mantenha a UI responsiva — sem conexões longas.
O formato de resposta permanece estável independentemente do roteamento upstream — consumed_credits, status e URLs de imagem são normalizados.
Três passos da chave de API até a URL da imagem final.
Entre, abra a página API Keys e copie uma chave para uso no servidor. Mantenha-a no backend — nunca no código do navegador.
Chame POST /v1/images/generations com model "seedream-5-pro", seu prompt, aspect_ratio, resolution e image_urls opcional. Você recebe task_id e estimated_credits.
Chame GET /v1/images/generations/:task_id. Quando status chegar a SUCCESS, leia images[0].url e exiba ou arquive o resultado.
Dois endpoints cobrem todo o ciclo — criar e fazer polling.
Cria uma tarefa Seedream 5 Pro. image_urls vazio = texto-para-imagem; 1–10 URLs = edição por referência. Resposta 202 com task_id e estimated_credits.
Retorna IN_PROGRESS, SUCCESS com images[].url ou FAILED com objeto de erro. Também informa consumed_credits ao concluir.
400 parâmetros inválidos, 401 chave inválida, 402 créditos insuficientes, 404 tarefa não encontrada, 429 rate limit, 503 upstream indisponível. Tabela completa na doc.
| Parâmetro | Valor |
|---|---|
| model | Deve ser "seedream-5-pro" — o único modelo público nesta rota. |
| prompt | Prompt de texto ou instrução de edição, 1–3000 caracteres. |
| aspect_ratio | Um de 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2. Padrão 1:1. |
| resolution | "1k" (padrão, 9 créditos) ou "2k" (18 créditos). |
| image_urls | 0–10 URLs HTTPS públicas. Array vazio = puro texto-para-imagem. |
Parâmetros desconhecidos são rejeitados com 400 UNKNOWN_PARAMETER — o contrato permanece explícito. Esquema completo em /docs/images.
Preço fixo por imagem em créditos Seedance API. A resposta de criação inclui estimated_credits; o status final informa consumed_credits.
| Modo | Créditos | Notas |
|---|---|---|
| Texto-para-imagem · 1K | 9 créditos / imagem | Resolução padrão — para iterações e previews. |
| Texto-para-imagem · 2K | 18 créditos / imagem | Qualidade de impressão para assets finais. |
| Edição por referência | +0,8 crédito / imagem extra | Primeira referência incluída; imagens 2–10 somam 0,8 cada. |
Respostas para desenvolvedores avaliando a API Seedream 5 Pro na Seedance API.
A Seedance API expõe o Seedream 5 Pro atrás de uma superfície REST estável — toda a capacidade do modelo com auth, cobrança e respostas normalizadas, sem gerenciar credenciais do provedor.
Array image_urls vazio para texto-para-imagem. 1–10 URLs HTTPS públicas para editar ou compor referências — o mesmo endpoint gerencia ambos os modos.
1:1, 4:3, 3:4, 16:9, 9:16, 2:3 e 3:2. Escolha a proporção que combina com seu posicionamento — o modelo compõe nativamente, sem cortar.
9 créditos por imagem 1K e 18 por 2K. Edição por referência soma 0,8 crédito por imagem extra. estimated_credits fica visível antes do polling.
Tarefas 1K típicas levam cerca de 15–25 segundos; 2K e multi-referência levam mais. Faça polling no endpoint de status — as tarefas são assíncronas por design.
Não — e não deve. Mantenha sua chave Bearer no backend, chame nossos endpoints do servidor e exponha apenas suas próprias rotas seguras.
Sim — texto multilíngue na imagem é um de seus pontos fortes: pôsteres, etiquetas de preço e criativos localizados com texto legível.
O esquema de requisição completo, exemplos de resposta, tabela de erros e detalhes de preço estão em /docs/images. Esta página é a visão geral da integração.
Obtenha uma chave de API, envie sua primeira tarefa de geração e conecte a geração de imagens flagship ao seu produto hoje.