Como obter uma chave de API do Seedream em 2026: passos no BytePlus, preços oficiais e uma alternativa com uma só chave

Você tem um prompt do Seedream que funciona em um app web e agora quer usá-lo no seu próprio código. Para isso, precisa de uma chave de API. Há dois caminhos: a nuvem da própria ByteDance, o BytePlus ModelArk, onde você cria uma chave, escolhe um ID de modelo e paga por imagem; ou uma plataforma de API que roda o Seedream atrás de uma única chave, junto com outros modelos. Este guia cobre os dois, com os passos exatos, os preços oficiais de 12 de outubro de 2026 e o que muda entre eles.

Resposta curta: entre no console do BytePlus, abra a página API keys, clique em Create API key e chame https://ark.ap-southeast.bytepluses.com/api/v3/images/generations com a chave como bearer token e um ID de modelo como dola-seedream-5-0-pro-260628. O Seedream 5.0 Pro custa $0.045 por imagem até 1.5K e $0.09 acima disso, o Flash custa $0.018 e o Lite, $0.035. O BytePlus aplica um filtro de conteúdo por padrão. Uma chave SpicyAPI roda as mesmas versões do modelo Seedream sem nenhum filtro adicional, a $0.036 por imagem 1K no 5.0 Pro, e a mesma chave chama também vídeo e outros modelos de imagem.

• Um modelo, conta oficial: BytePlus ModelArk. O caminho mais barato para o Seedream 5.0 Flash.
• Vários modelos, trabalho voltado a adultos ou preço menor no Pro: uma chave de plataforma de API, como a SpicyAPI.
• Páginas de "chave de API do Seedream grátis": a lista de preços oficial não tem cota gratuita de saída. As chaves compartilhadas na internet são a cota de outra pessoa.

Opção 1: obter uma chave de API do Seedream no BytePlus ModelArk

O BytePlus é a nuvem internacional da ByteDance, e o ModelArk é o serviço de modelos dela. O Seedream é um dos modelos de imagem de lá, ao lado do vídeo Seedance e dos modelos de linguagem Seed. Uma conta e uma chave cobrem todos eles.

1. Crie uma conta no BytePlus e entre no console. Adicione uma forma de pagamento antes de depender dela: segundo a página oficial de preços, uma conta que fica em atraso por duas horas tem os serviços de modelo suspensos até receber uma recarga.
2. Abra a página de chaves de API. Se a sua organização usa espaços de projeto, troque primeiro para o correto no canto inferior esquerdo, porque uma chave só alcança os modelos do próprio projeto.
3. Clique em Create API key, confirme o nome e clique em Create. A chave aparece na lista de chaves de API. As chaves criadas depois de 17 de setembro de 2026 usam um novo formato de texto simples; as mais antigas continuam funcionando.
4. Coloque a chave em uma variável de ambiente (a documentação usa ARK_API_KEY) em vez de colocá-la no código.

Os passos oficiais para a chave terminam aí. O console também tem uma página Model activation, que mostra seus limites de taxa; vários guias de terceiros acrescentam uma etapa de ativação antes da primeira chamada de imagem, então, se uma chamada for rejeitada por acesso, essa página é o primeiro lugar a olhar.

Depois, chame o endpoint de imagem com o ID do modelo:

curl https://ark.ap-southeast.bytepluses.com/api/v3/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "dola-seedream-5-0-pro-260628",
    "prompt": "An adult woman in her early thirties in a cream silk blouse reads a paperback by a rain-streaked café window at dusk, warm lamp light on her face, city lights blurred outside, a cup of coffee on the marble table, calm and absorbed expression, cinematic photograph, 50mm lens, shallow depth of field, natural skin texture",
    "size": "2K",
    "output_format": "png",
    "watermark": false
  }'

A chamada é síncrona. A resposta tem um array data, e o url de cada item é um link de download de uma imagem. O link é mantido por apenas 24 horas, então baixe ou copie o arquivo para o seu próprio armazenamento imediatamente. Defina response_format como b64_json se preferir receber os bytes da imagem na resposta. watermark tem o padrão true, que adiciona uma marca visível; defina como false se não quiser uma.

Mais três coisas que vale saber antes de construir em cima disso:

• Restrinja cada chave. Uma chave pode ser limitada a IDs de modelo e a endereços IP específicos. Uma conta pode ter até 50 chaves, então uma chave separada e restrita por app é um seguro barato contra vazamentos.
• Fique de olho no limite de taxa. O Seedream 5.0 Pro e o Flash permitem 500 imagens por minuto por versão de modelo em uma conta; acima disso, as chamadas retornam um erro.
• A moderação de conteúdo vem ativada por padrão. O pré-filtro de conteúdo do ModelArk cobre conteúdo adulto e gráfico e vem ativado nos novos endpoints; dá para desligá-lo por endpoint, mas continua valendo uma base de políticas de conteúdo do BytePlus. Imagens bloqueadas não são cobradas.

IDs de modelo do Seedream no BytePlus

O BytePlus agora chama os modelos 5.0 Pro e Flash de "Dola Seedream". É a mesma linha de modelos. O sufixo de data muda quando uma nova versão é lançada, então copie o ID da lista de modelos em vez de adivinhá-lo.

Preços oficiais da API do Seedream

Da página de preços do ModelArk, consultada em 12 de outubro de 2026:

A lista não tem cota gratuita de saída. Um lote de 1.000 imagens do Seedream 5.0 Pro em 2K custa $90, e 1.000 imagens do Flash custam $18.

Opção 2: usar o Seedream com uma só chave da SpicyAPI

Uma plataforma de API dá uma chave para muitos modelos e cuida das contas de provedores por trás. Na SpicyAPI, os passos são:

1. Cadastre-se e abra API keys no console.
2. Crie uma chave. Você pode limitá-la por dia, por mês e durante toda a vida útil, e restringir quais modelos ela pode chamar.
3. Adicione saldo por cartão, Apple Pay, Google Pay ou cripto. É um saldo em dólares americanos, sem assinatura, e o saldo pago não expira.
4. Chame o endpoint de tarefas com o nome do modelo:

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data '{
    "model": "bytedance/seedream-5.0-pro/text-to-image",
    "input": {
      "prompt": "An adult woman in her early thirties in a cream silk blouse reads a paperback by a rain-streaked café window at dusk, warm lamp light on her face, city lights blurred outside, a cup of coffee on the marble table, calm and absorbed expression, cinematic photograph, 50mm lens, shallow depth of field, natural skin texture",
      "resolution": "2k",
      "aspect_ratio": "16:9"
    }
  }'

Esta chamada é assíncrona: devolve um ID de tarefa imediatamente. Consulte GET https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=<id> até a tarefa terminar, ou informe uma URL de callback ao criá-la. As imagens prontas ficam no armazenamento próprio da SpicyAPI por até 14 dias, atrás de links assinados, então você não corre contra uma expiração de 24 horas. A referência da API tem os campos, e a página do Seedream 5.0 Pro traz o schema de entrada completo, incluindo edições com imagens de referência e decomposição em camadas.

Preços por imagem em 12 de outubro de 2026:

O Pro custa 20% menos que o preço oficial nos dois tamanhos; a SpicyAPI oferece 1K e 2K, não 1.5K. Lite e 4.0 custam praticamente o mesmo. O Flash custa mais na SpicyAPI do que no BytePlus. Se o Flash é tudo de que você precisa e o seu conteúdo se encaixa nas políticas do BytePlus, a chave oficial é a opção mais barata.

A diferença maior é o que volta. A SpicyAPI não adiciona filtro de conteúdo ao Seedream. Nos nossos testes de setembro, o Seedream 5.0 Pro entregou 33 de 34 execuções voltadas a adultos, entre texto para imagem e edição, o Lite entregou todas as 34, e o Flash suavizou um par dos pedidos mais fortes. Os resultados completos estão em O Seedream é sem censura?. O próprio modelo ainda decide o que desenha, e personagens adultos e os direitos de qualquer foto que você edite continuam sendo responsabilidade sua.

Qual chave você deve escolher?

Você também pode usar as duas: o BytePlus para o trabalho geral em que ele é mais barato e uma chave de plataforma para todo o resto.

E uma "chave de API do Seedream grátis"?

"Seedream API key free" e "Seedream API key generator" são buscas comuns. Não existe chave oficial gratuita. O BytePlus cobra cada imagem de saída, e as imagens de entrada são grátis. Chaves publicadas no GitHub ou em fóruns pertencem à conta de outra pessoa. Elas param de funcionar quando o dono percebe, e tudo o que você construir em cima de uma delas quebra junto. Sites geradores que prometem uma chave grátis ou revendem acesso ou distribuem chaves que não são deles.

A forma honesta e mais barata de testar é enviar algumas imagens: dez imagens do Seedream 5.0 Pro em 1K custam menos de 50 centavos em qualquer um dos caminhos. Na SpicyAPI, tarefas com falha geralmente não são cobradas (cada página de modelo informa se um modelo é exceção), e o preço de uma execução aparece antes de você enviá-la.

Solução de problemas de uma chave nova

• 401 ou "invalid API key": confira se o cabeçalho é Authorization: Bearer <key> e se não há espaço ou quebra de linha no fim da sua variável de ambiente.
• Erros de acesso ou "model not found" no BytePlus: o ID do modelo está escrito errado, a chave está restrita a outros modelos ou a chave pertence a outro espaço de projeto. Se nada disso se aplicar, confira a página Model activation.
• Erros de conteúdo no BytePlus: o pré-filtro bloqueou o prompt ou a saída. Eles não são cobrados. Reescrever pode ajudar em conteúdo geral no limite. Para trabalho voltado a adultos, leia primeiro a política de uso do BytePlus, porque as regras básicas de conteúdo dele valem para a conta inteira, mesmo com o filtro desligado.
• Os links param de funcionar no dia seguinte: as URLs de imagem do BytePlus expiram após 24 horas. Salve o arquivo quando a resposta chegar.
• As chamadas param depois de dias funcionando: confira o saldo da conta. Uma conta em atraso por duas horas fica suspensa até receber uma recarga.

Perguntas frequentes

Onde encontro a minha chave de API do Seedream?

No console do BytePlus, na página de chaves de API. Na SpicyAPI, em Console → API keys. Nos dois, a lista de chaves mostra as chaves que você criou.

A API do Seedream é grátis?

Não. No BytePlus, cada imagem de saída é cobrada, de $0.018 no 5.0 Flash a $0.09 no 5.0 Pro acima de 1.5K. As imagens de entrada são grátis, exceto que o Seedream 5.0 Pro cobra $0.003 por cada imagem de entrada depois da primeira.

Qual é o ID de modelo do Seedream 5.0?

No BytePlus, dola-seedream-5-0-pro-260628 para o Pro, dola-seedream-5-0-flash-260915 para o Flash e seedream-5-0-lite-260128 para o Lite. Na SpicyAPI, bytedance/seedream-5.0-pro/text-to-image e os nomes equivalentes para Flash, Lite e edições.

Posso usar a API do Seedream para imagens NSFW?

Não com as configurações padrão do BytePlus: o pré-filtro de conteúdo bloqueia conteúdo adulto, e as políticas de conteúdo do BytePlus valem mesmo com ele desligado. Na SpicyAPI não há filtro adicional, e o Seedream 5.0 Pro e o Lite entregaram quase todos os nossos testes voltados a adultos.

Seedream 4.5 ou 5.0?

No BytePlus, o 5.0 Lite ($0.035) custa menos que o 4.5 ($0.04), e o 5.0 Flash ($0.018) custa menos que qualquer um dos dois. O Pro é o que vale pagar mais, quando a qualidade da imagem importa mais. Nossa comparação entre Lite, Pro e Flash traz resultados lado a lado.

Conclusão

Obter uma chave de API do Seedream no BytePlus leva alguns minutos: criar uma chave, usar o ID de modelo certo, salvar cada imagem dentro de 24 horas e ficar de olho no saldo. É o caminho mais barato para o Seedream 5.0 Flash e o certo para trabalho geral em uma conta direta com a ByteDance. Se você quer o Seedream ao lado de outros modelos de imagem e vídeo com uma só chave, um preço menor no Pro, resultados disponíveis por até duas semanas ou imagens voltadas a adultos sem um filtro do provedor, uma chave SpicyAPI cobre isso.

Crie uma chave SpicyAPI e experimente o Seedream 5.0 Pro →