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.

3 min de leitura

seedancevídeotutorial

Vista aérea de uma cidade ao redor de uma torre alta, quadro de um vídeo do Seedance

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:

bash
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:

json
{ "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:

bash
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:

bash
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.

python
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

Também em English, Tiếng Việt, Español