API do Seedance: faça seu primeiro vídeo em três chamadas
Inicie um trabalho de vídeo no Seedance, consulte o andamento e baixe o MP4 com HTTP simples. Um passo a passo completo com curl e Python, e quanto custa cada etapa.

Modelos de vídeo não respondem em uma única requisição como os modelos de chat. Um vídeo leva de um a cinco minutos para ficar pronto, então a API o executa como um trabalho: você o inicia, acompanha o andamento e busca o arquivo quando ele termina. Este post mostra as três chamadas com um modelo Seedance, primeiro com curl e depois como um script curto em Python.
Você precisa de uma conta na API Store com algum saldo e de uma chave de API da página Chaves de API. As chaves começam com sk-.
Passo 1: inicie o trabalho
Envie o modelo, um prompt e, se quiser, a duração, a resolução e a proporção para POST /videos:
curl https://api.apistore.cloud/v1/videos \
-H "Authorization: Bearer $APISTORE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0-mini",
"prompt": "A paper boat drifts down a rain gutter, close-up, soft morning light",
"seconds": 5,
"resolution": "720p",
"ratio": "16:9"
}'A resposta chega na hora. Ela traz o id do trabalho e o status dele:
{ "id": "video_8f2c...", "status": "queued", "model": "seedance-2.0-mini" }Se você omitir os campos opcionais, recebe 5 segundos em 720p, em 16:9, com som. O som (fala, música e efeitos) é gerado junto com a imagem; envie "audio": false se não quiser.
Passo 2: consulte até terminar
Peça o trabalho a cada poucos segundos:
curl https://api.apistore.cloud/v1/videos/video_8f2c... \ -H "Authorization: Bearer $APISTORE_API_KEY"
O status passa de queued para in_progress e termina como completed ou failed. Um trabalho concluído também traz usage.video_tokens e usage.cost_usd, então você sabe exatamente quanto ele custou. Um trabalho com falha traz error.code e error.message e não é cobrado.
Passo 3: baixe o arquivo
Um trabalho concluído tem uma url: um link para o MP4 que funciona por uma semana e é renovado sempre que você lê o trabalho. Você também pode sempre buscar o arquivo pela API:
curl -L https://api.apistore.cloud/v1/videos/video_8f2c.../content \ -H "Authorization: Bearer $APISTORE_API_KEY" -o boat.mp4
O mesmo em Python
Não é preciso SDK: o pacote requests basta.
import os, time, requests
BASE = "https://api.apistore.cloud/v1"
HEAD = {"Authorization": f"Bearer {os.environ['APISTORE_API_KEY']}"}
job = requests.post(f"{BASE}/videos", headers=HEAD, json={
"model": "seedance-2.0-mini",
"prompt": "A paper boat drifts down a rain gutter, close-up, soft morning light",
"seconds": 5,
"resolution": "720p",
}).json()
while job["status"] not in ("completed", "failed"):
time.sleep(5)
job = requests.get(f"{BASE}/videos/{job['id']}", headers=HEAD).json()
if job["status"] == "failed":
raise SystemExit(f"{job['error']['code']}: {job['error']['message']}")
video = requests.get(f"{BASE}/videos/{job['id']}/content", headers=HEAD)
open("boat.mp4", "wb").write(video.content)
print("cost", job["usage"]["cost_usd"], "USD")Quanto custa
O vídeo é cobrado pelo vídeo que o modelo realmente gerou. O preço depende do modelo e da resolução, e o site o mostra por segundo gerado. O Seedance 2.0 mini em 480p, a combinação mais barata hoje, custa US$ 0,0202 por segundo, e US$ 0,0454 por segundo em 720p.
Quando o trabalho começa, o custo do resultado mais longo que ele poderia produzir é reservado do seu saldo. Quando ele termina, você paga pelo que foi gerado e o resto é liberado. Se o trabalho falhar, nada é cobrado. Como a geração de vídeo é cobrada explica os números em detalhes.
Com qual modelo começar
- Seedance 2.0 mini para testes e rascunhos: o menor preço, 480p e 720p.
- Seedance 2.0 fast quando você quer mais qualidade a um preço moderado.
- Seedance 2.0 para a melhor imagem da família 2.0, até 1080p e 4K.
- Seedance 2.5 para vídeos longos de até 30 segundos, muitos arquivos de referência e para editar ou estender um vídeo.
Os quatro aceitam a mesma requisição, então você troca de modelo mudando uma palavra. Qual modelo Seedance escolher compara os quatro lado a lado.
Próximos passos
- Dê ao modelo um primeiro quadro ou imagens de referência: veja a documentação de vídeo.
- Teste um prompt no playground antes de escrever código.
- Confira a lista de preços de cada modelo e resolução.
Também em English, Tiếng Việt, Español

