Pular para o conteúdo principal
A Krea oferece acesso via API aos modelos de geração de vídeo Seedance da ByteDance. Use a Seedance API na Krea para gerar vídeos a partir de texto, animar imagens ou guiar a geração com referências de imagem, vídeo e áudio. As requisições usam um token da Krea API e a URL base https://api.krea.ai.

Modelos disponíveis da Seedance API

Esses modelos são compatíveis com texto para vídeo, frames inicial e final, mídias de referência e áudio nativo. O Seedance 2.5 também oferece o modo rascunho, uma prévia barata em 480p que você pode renderizar em qualidade total depois. Consulte a referência da API para ver o schema de requisição atual de cada modelo. Confira os preços da API ↗ antes de enviar um job; o preço depende do modelo e das configurações de geração.
Os endpoints do Seedance 2.0 e 2.0 Fast na Krea incluem aprimoramento de prompt e upscaling opcionais da Krea, além do modelo base. O Seedance 2.5 inclui aprimoramento de prompt opcional da Krea. Em requisições de edição de vídeo do Seedance 2.5 com reference_videos, a duração e a proporção da saída vêm do vídeo de origem; duration e aspect_ratio são ignorados nessas requisições.

Obtenha uma chave da Seedance API

Crie um token da Krea API e adicione saldo de API seguindo Chaves de API e faturamento. Armazene o token na variável de ambiente KREA_API_KEY no seu servidor. Envie-o como Authorization: Bearer $KREA_API_KEY; nunca o exponha em código executado no navegador. As unidades de computação do app da Krea e o saldo de API são separados. Requisições ao Seedance pela Krea API usam o saldo de API do seu workspace.

Gere um vídeo

Envie um prompt ao endpoint do Seedance 2.5 para geração de texto para vídeo. Estes exemplos solicitam um vídeo horizontal de cinco segundos em 720p.
Instale o SDK JavaScript com npm install @krea-ai/sdk. A requisição REST retorna um job_id, não o vídeo finalizado. Faça polling em GET /jobs/{job_id} a cada 2–5 segundos até que status seja completed e, em seguida, leia a URL do vídeo em result.urls[0]. Interrompa o polling em failed ou cancelled. O método jobs.wait do SDK faz o polling para você.
cURL
Em integrações de produção, use webhooks para receber eventos de conclusão. Consulte Ciclo de vida do job e Erros e depuração para ver os estados dos jobs e o tratamento de falhas.

Anime uma imagem

Para geração de imagem para vídeo com o Seedance, use o mesmo endpoint e adicione start_image à sua requisição. Envie uma URL de imagem acessível publicamente, a URL de um asset enviado ou um data URI em base64.
Substitua start_image pela URL da sua própria imagem. Para controlar o frame final, adicione end_image. Para geração guiada por referências, use reference_images, reference_videos e reference_audios de acordo com o schema da API do modelo selecionado.

Pré-visualizar uma cena com o modo rascunho

O modo rascunho do Seedance 2.5 gera uma prévia rápida em 480p da sua solicitação, cobrada pela tarifa de 480p. Use-o para conferir composição, movimento e a intenção do prompt antes de pagar por uma renderização completa. Quando um rascunho estiver bom, envie o ID do job dele para o mesmo endpoint. O modelo então gera novamente a mesma cena em qualidade total, em vez de começar uma nova.
1

Gere um rascunho

Adicione "draft": true a uma solicitação normal do Seedance 2.5. Rascunhos sempre são renderizados em 480p, então qualquer resolution enviada com draft é ignorada.
cURL
Consulte o job_id retornado até que o status seja completed e depois revise o vídeo em 480p.
2

Renderize o rascunho em qualidade total

Envie o ID do job do rascunho como draft_job_id. Faça isso em até 7 dias após criar o rascunho; depois disso, ele não pode mais ser renderizado e você precisa gerar um novo.
cURL
Envie apenas draft_job_id. A renderização completa reutiliza o prompt, as referências, a seed, a duração e a proporção do rascunho, então você não precisa enviá-los de novo; a Krea ignora qualquer um deles que você incluir. A saída é 1080p por padrão. Adicione "resolution": "4k" para renderizar em 4K.
O mesmo fluxo com o SDK de JavaScript:
JavaScript

Cobrança do modo rascunho

Um rascunho é cobrado pela tarifa de 480p. A renderização completa é cobrada como uma geração separada do Seedance 2.5 na resolução de saída, pela duração do rascunho. Se o rascunho usou vídeos de referência, a renderização completa é cobrada pelos tokens informados pela ByteDance, e esses tokens incluem a duração dos vídeos de referência do rascunho. Renderizar o mesmo rascunho novamente na mesma resolução retorna o job de qualidade total existente, em vez de criar e cobrar um novo.

Limites e erros do modo rascunho

  • Apenas o Seedance 2.5 oferece o modo rascunho. Seedance 2.0, 2.0 Fast e 2.0 Mini não oferecem.
  • Você só pode renderizar seus próprios rascunhos, a partir do mesmo workspace.
  • Não envie draft: true e draft_job_id na mesma solicitação. Um rascunho não pode ser renderizado a partir de outro rascunho.

Perguntas frequentes

A Krea oferece uma API do ByteDance Seedance?

Sim. A Krea oferece o ByteDance Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast e Seedance 2.0 Mini pela sua API REST em https://api.krea.ai. Autentique-se com um token da Krea API e envie uma requisição a um dos endpoints do Seedance listados acima.

Posso usar o Seedance tanto para texto para vídeo quanto para imagem para vídeo?

Sim. Envie um prompt para texto para vídeo ou adicione start_image para animar uma imagem. Os dois fluxos usam o mesmo endpoint do modelo Seedance e retornam um job assíncrono.

Posso pré-visualizar um vídeo do Seedance antes de pagar pela qualidade total?

Sim, com o Seedance 2.5. Envie "draft": true para receber uma prévia em 480p pela tarifa de 480p. Se gostar, envie o ID do job do rascunho como draft_job_id em até 7 dias para renderizar a mesma cena em 1080p. Veja o modo rascunho.

Preciso de uma chave de API separada da ByteDance?

Não. Chamadas ao Seedance pela Krea usam seu token da Krea API e o saldo de API do workspace. Você não precisa enviar uma credencial separada da ByteDance nessas requisições.

Quanto custa a Seedance API na Krea?

Consulte os preços da Krea API ↗ para ver os preços atuais do Seedance e as configurações disponíveis. O uso da API é cobrado separadamente das unidades de computação do app da Krea. Jobs que falham ou são cancelados não são cobrados.

Posso chamar o Seedance a partir de um agente de IA?

Sim. Conecte um agente ao servidor MCP da Krea para descobrir os modelos de vídeo disponíveis e seus schemas. Você também pode chamar a API REST ou o SDK JavaScript diretamente da sua aplicação.