Como usar a API do Seedance 2.0? Faça seu primeiro vídeo em 5 minutos

TL;DR

• O Seedance 2.0 é o modelo de geração de vídeo da ByteDance; no HiAPI ele é dividido em três níveis: Mini, Fast e Standard. Abra a página do modelo e gere online; novos usuários ganham 200 créditos ao se cadastrar.
• Cobrança por segundo: Mini 720p a $0.0586 por segundo, Standard 720p a $0.293 por segundo, 1080p pela rota ext a $0.342 por segundo; áudio sem custo adicional.
• A API tem apenas duas etapas: envie com POST /v1/tasks e consulte o resultado com o taskId. Basta copiar o curl e o Python abaixo para executar.

O que o Seedance 2.0 pode fazer?

• Texto para vídeo: de 4 a 15 segundos, de 480p a 4K, seis proporções de tela: 16:9, 9:16, 1:1, 4:3, 3:4 e 21:9; em imagem para vídeo também é possível usar adaptive para seguir a imagem original.
• Imagem para vídeo: envie o primeiro frame (first_frame_url) e, opcionalmente, adicione o último frame (last_frame_url) para controlar a imagem final.
• Referência multimodal: até 9 imagens de referência, 3 vídeos de referência e 3 áudios de referência, usados para fixar personagens, movimentos de câmera ou ritmo.
• Áudio nativo: generate_audio vem ativado por padrão; o ambiente sonoro e os efeitos sonoros são gerados em sincronia com a imagem.

O plano de produto de 5 segundos em 720p abaixo foi gerado diretamente com um único prompt:

A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a
brushed-concrete pedestal, soft diffused studio light, the screen wakes to
show a glowing minimalist watch face, faint reflections move across the metal
bezel, premium tech commercial look, calm and clean.

Gerar com este prompt →

Duas formas de começar

Teste online (sem código)

1. Abra a página do modelo Seedance 2.0 e cadastre-se ou faça login.
2. Cole o prompt e escolha a duração, a resolução e a proporção de tela.
3. Clique em gerar e baixe o vídeo diretamente quando estiver pronto (os três vídeos de exemplo de latte de 5 segundos em 720p da página de preços levaram de 168 a 230 segundos desde o envio até a conclusão).

Chamada da API

1. Crie uma API Key no console.
2. Envie a tarefa com POST https://api.hiapi.ai/v1/tasks; a resposta retorna o taskId.
3. Consulte o status com GET /v1/tasks/{taskId}; quando status for success, baixe o vídeo em output[0].url.

curl: o primeiro vídeo

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "input": {
      "prompt": "A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a brushed-concrete pedestal, soft diffused studio light.",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'

Retorno:

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

Consultar o resultado:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Python: enviar, consultar e baixar

# pip install requests; antes, export HIAPI_KEY=sua_Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(prompt, model="seedance-2.0", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    # Ao reenviar a mesma tarefa, use o mesmo Idempotency-Key para evitar cobrança duplicada
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

url = generate(
    "A barista pours steamed milk into a latte, camera slowly pulls back",
    model="seedance-2.0-mini", duration=5, resolution="480p", aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Ao ajustar o prompt, troque model para seedance-2.0-mini e use a resolução 480p: 5 segundos custam apenas $0.136; depois de finalizar, troque para a versão Standard ou para a rota ext para gerar em alta definição.

Imagem para vídeo e referência multimodal

Imagem para vídeo com primeiro frame: adicione first_frame_url em input e defina a proporção de tela como adaptive para seguir a proporção da imagem:

{
  "model": "seedance-2.0",
  "input": {
    "prompt": "Slow cinematic push-in on the product with a soft light sweep, keep the product still and centered",
    "first_frame_url": "https://your-cdn.example.com/product.jpg",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "resolution": "720p"
  }
}

Imagens, vídeos e áudios de referência: use, respectivamente, reference_image_urls (imagens de referência mais os frames inicial e final, no máximo 9 no total), reference_video_urls (no máximo 3 trechos, com duração total de até 15 segundos) e reference_audio_urls (no máximo 3 trechos, com duração total de até 15 segundos).

Combinações de entrada do Mini: no Mini, escolha entre primeiro frame, imagem de referência ou vídeo de referência; duration e resolution são obrigatórios; na versão Standard, aspect_ratio é obrigatório.

Rota ext: adicione "route": "ext" no nível superior e mantenha o nome do modelo. A rota ext só tem 720p, 1080p e 4K, sai mais barata por segundo, mas não aceita vídeos de referência.

Atenções antes de ir para produção

• Use callback em vez de polling: adicione "callback": {"url": "https://seu-dominio/hiapi/callback"} no nível superior da requisição; quando a tarefa terminar (com sucesso ou falha), o HiAPI notifica ativamente; deduplique pelo taskId.
• Os vídeos são mantidos por cerca de 7 dias por padrão: após obter output[0].url, transfira o arquivo para o seu próprio armazenamento; para retenção de longo prazo, use o armazenamento persistente do HiAPI (cobrado separadamente pelo volume armazenado).
• Preencha todos os parâmetros: escreva explicitamente duration, resolution e aspect_ratio para que o custo corresponda à sua planilha de orçamento.
• Reembolso automático em caso de falha: tarefas com falha não são cobradas; a cobrança considera apenas os segundos gerados com sucesso.

Perguntas frequentes

Como escolher entre Mini, Fast e Standard?

Use Mini para ajustar prompts; para vídeos curtos de redes sociais, use Mini ou Fast em 720p; para 1080p / 4K, use a versão Standard ou a rota ext. Consulte os preços detalhados em Preços da API do Seedance 2.0.

Posso escrever o prompt em chinês?

Sim. Chinês e inglês são suportados; para maior estabilidade, descreva claramente em frases separadas o enquadramento, a ação, a iluminação e o som.

É possível gerar vídeos verticais?

Sim. Defina aspect_ratio como 9:16; em imagem para vídeo, use adaptive para seguir a proporção do primeiro frame.

Quanto tempo leva para gerar um vídeo?

Os três vídeos de exemplo de latte de 5 segundos em 720p da página de preços levaram de 168 a 230 segundos desde o envio até a conclusão. Em produção, use callbacks para receber os resultados, não dependa de um tempo de espera fixo.

Copie o prompt do relógio acima e vá à página do modelo para gerar seu primeiro vídeo; se quiser mais prompts prontos, veja Exemplos de prompts do Seedance 2.0.