Como usar a API de texto para vídeo do Seedance 2.5? Rode direto com curl e Python

TL;DR

• seedance-2.5/text-to-video gera um vídeo com apenas um prompt, de 4–30 segundos por vídeo, com áudio próprio. Abra a página do modelo para gerar online; novos usuários ganham 200 créditos ao se cadastrar.
• Cobrança por segundo: 720p custa $0.204 por segundo, 1080p custa $0.516 por segundo. 5 segundos em 720p custa $1.02.
• A API tem duas etapas: POST /v1/tasks para enviar e obter o taskId para consultar o resultado. O curl e o Python abaixo podem ser copiados e executados direto.

Veja primeiro um resultado real

O vídeo de 8 segundos em 720p abaixo foi gerado com um prompt e uma única requisição; o som de leite vaporizado, o tilintar de xícaras e as vozes no café foram todos criados pelo próprio modelo:

A barista in a small morning cafe pours steamed milk into a cup, drawing a latte art leaf.
The camera starts on her hands and slowly pulls back to reveal the counter and a sign on the wall that reads 'OPEN'.
Warm window light, realistic, smooth motion. Sound: milk steaming, cups clinking, quiet cafe chatter.

Gerar com este prompt → (8 segundos, 720p)

seedance-2.5/text-to-video, 720p, 8 segundos, com áudio, $1.632.

Duas formas de começar

Teste online (sem escrever código)

1. Abra a página do modelo Seedance 2.5 Texto para Vídeo, cadastre-se ou faça login.
2. Cole o prompt, escolha a duração, a resolução e a proporção.
3. Clique em gerar e baixe o vídeo assim que ficar pronto.

Chamada via API

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

curl: o primeiro vídeo

Primeiro, rode um vídeo de 5 segundos em 720p, por $1.02:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5/text-to-video",
    "input": {
      "prompt": "一架纸飞机滑过洒满阳光的办公室，灰尘在光里漂浮，镜头跟着纸飞机缓慢移动",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  }'

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"

Durante a geração, status é handling; após concluir, passa a success, e o endereço do vídeo fica em output[0].url.

Python: enviar, consultar e baixar

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

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

def generate(prompt, model="seedance-2.5/text-to-video", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    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(
    "一架纸飞机滑过洒满阳光的办公室，灰尘在光里漂浮，镜头跟着纸飞机缓慢移动",
    duration=5, resolution="720p", aspect_ratio="16:9",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Visão geral dos parâmetros

Parâmetro	Valores	Descrição
prompt	string, obrigatório	Aceita chinês e inglês
duration	inteiro de 4–30, padrão 5	Em segundos, cobrado por segundo
resolution	720p / 1080p, padrão 720p	O preço unitário de 1080p é cerca de 2.5 vezes o de 720p
aspect_ratio	16:9 4:3 1:1 3:4 9:16 21:9 adaptive, padrão adaptive	Para vídeos curtos em vertical, use 9:16
generate_audio	padrão true	Áudio e imagem são gerados juntos
output_format	mp4 / mov

Texto para vídeo não aceita nenhuma URL de imagem ou vídeo. Para começar a partir de uma imagem, use Seedance 2.5 Imagem para Vídeo; para usar como referência o movimento e a câmera de um vídeo existente, use Seedance 2.5 Referência para Vídeo.

Calcule o custo

Duração	720p ($0.204/s)	1080p ($0.516/s)
5 segundos	$1.02	$2.58
10 segundos	$2.04	$5.16
15 segundos	$3.06	$7.74
30 segundos	$6.12	$15.48

Com $10, você gera cerca de 49 segundos em 720p. Recomenda-se ajustar o prompt primeiro com durações curtas em 720p e depois gerar o vídeo final em 1080p. Para as contas mais detalhadas, veja Preços da API do Seedance 2.5.

Cuidados antes de ir para produção

• Use callback em vez de polling: no nível superior da requisição (no mesmo nível de input), adicione "callback": {"url": "https://seu-dominio/hiapi/callback"}; ao final da tarefa, a HiAPI notifica ativamente; deduplique por taskId.
• Salve imediatamente: output[0].url é um link temporário (mantido por cerca de 7 dias por padrão); assim que receber, salve no seu próprio armazenamento.
• Use chave de idempotência ao tentar novamente: adicione Idempotency-Key no cabeçalho da requisição; repetir com a mesma chave cria a tarefa apenas uma vez e não cobra em duplicidade.
• Preencha todos os parâmetros: informe explicitamente duration, resolution e aspect_ratio para que o custo e a proporção batam com o orçamento.
• Reembolso automático em caso de falha: a cobrança é feita apenas pelos vídeos gerados com sucesso.

Perguntas frequentes

Dá para escrever o prompt em chinês?

Dá. Para maior consistência, descreva em frases separadas como a câmera se move, como o sujeito se move e quais sons existem.

Qual é a duração máxima de geração?

4–30 segundos por vídeo. É o dobro do limite de 15 segundos do Seedance 2.0, adequado para planos longos sem cortes.

Desligar o áudio economiza?

Definir generate_audio como false desliga o áudio, mas o preço é calculado por resolução e segundos; não fica mais barato por isso.

Como escolher entre ele e o Seedance 2.0?

Escolha o 2.5 se precisar de vídeos únicos mais longos e mais material de referência; se a prioridade for orçamento ou se precisar de 4K, escolha a linha ext do 2.0 (720p a $0.134 por segundo). Para uma comparação detalhada, veja as diferenças entre Seedance 2.5 e 2.0.

Para mais formas prontas de escrever, veja o manual de uso do Seedance 2.5; você também pode copiar o prompt de latte art acima e gerar na página do modelo.