Guia da API Seedream 5 Pro

API Seedream 5 Pro para geração de imagens IA

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.

Resolução
1K / 2K

Saída 1K ou 2K

Proporções
7

1:1 a 16:9, 9:16, 2:3, 3:2

Entradas
T2I + I2I

Prompt ou até 10 imagens de referência

Interface
REST

JSON sobre HTTPS

Requisição inicial

Criar uma tarefa de imagem Seedream 5 Pro

seedream-5-pro
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.

Por que integrar a API Seedream 5 Pro

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.

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.

Um alias de modelo estável

Você chama model "seedream-5-pro". Roteamento, capacidade e fallbacks ficam do nosso lado — sua integração não sofre mudanças upstream.

Preço em créditos previsível

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.

Capacidades da API Seedream 5 Pro

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.

Geração texto-para-imagem

Envie um prompt de até 3000 caracteres com proporção e resolução — o modelo cuida de composição, luz e tipografia na imagem.

Edição multi-referência

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.

Saída em alta resolução 2K

Defina resolution como "2k" para renders com qualidade de impressão e assets finais. 1K cobre previews e iterações.

Texto multilíngue na imagem

Um dos maiores pontos fortes — texto legível em inglês, chinês, japonês e mais dentro de pôsteres e letreiros.

Arquitetura de jobs assíncronos

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.

Respostas independentes do provedor

O formato de resposta permanece estável independentemente do roteamento upstream — consumed_credits, status e URLs de imagem são normalizados.

Como chamar a API Seedream 5 Pro

Três passos da chave de API até a URL da imagem final.

1

Criar uma chave de API

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.

2

Enviar uma tarefa de geração

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.

3

Fazer polling e renderizar

Chame GET /v1/images/generations/:task_id. Quando status chegar a SUCCESS, leia images[0].url e exiba ou arquive o resultado.

Referência de endpoints

Dois endpoints cobrem todo o ciclo — criar e fazer polling.

POST /v1/images/generations

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.

GET /v1/images/generations/:task_id

Retorna IN_PROGRESS, SUCCESS com images[].url ou FAILED com objeto de erro. Também informa consumed_credits ao concluir.

Erros e limites

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âmetros da requisição

ParâmetroValor
modelDeve ser "seedream-5-pro" — o único modelo público nesta rota.
promptPrompt de texto ou instrução de edição, 1–3000 caracteres.
aspect_ratioUm 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_urls0–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 em créditos

Preço fixo por imagem em créditos Seedance API. A resposta de criação inclui estimated_credits; o status final informa consumed_credits.

ModoCréditosNotas
Texto-para-imagem · 1K9 créditos / imagemResolução padrão — para iterações e previews.
Texto-para-imagem · 2K18 créditos / imagemQualidade de impressão para assets finais.
Edição por referência+0,8 crédito / imagem extraPrimeira referência incluída; imagens 2–10 somam 0,8 cada.

FAQ da API Seedream 5 Pro

Respostas para desenvolvedores avaliando a API Seedream 5 Pro na Seedance API.

Esta é a API oficial do ByteDance Seedream 5 Pro?

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.

Qual a diferença entre texto-para-imagem e edição por referência?

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.

Quais proporções o Seedream 5 Pro suporta?

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.

Quanto custa uma imagem Seedream 5 Pro?

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.

Quanto tempo leva uma geração?

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.

Posso chamar esta API pelo navegador?

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.

O Seedream 5 Pro renderiza texto dentro das imagens?

Sim — texto multilíngue na imagem é um de seus pontos fortes: pôsteres, etiquetas de preço e criativos localizados com texto legível.

Onde está a documentação completa da API?

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.

Crie sua primeira imagem Seedream 5 Pro

Obtenha uma chave de API, envie sua primeira tarefa de geração e conecte a geração de imagens flagship ao seu produto hoje.