Seedance 2.5 texto para vídeo: crie clipes curtos com a API hiapi

Vídeos curtos são um jogo de volume: TikTok, Reels e Shorts recompensam a frequência de publicação, e gravar B-roll manualmente para cada post não escala. O endpoint de texto para vídeo do Seedance 2.5 transforma um único prompt em um clipe vertical finalizado, com áudio sincronizado, em apenas uma chamada de API — sem câmera, sem linha do tempo de edição, sem dublagem separada.

Este guia percorre um clipe real que geramos de ponta a ponta pela API hiapi: o prompt exato, o fluxo de trabalho assíncrono que o produziu, o preço verificado e um padrão pronto para produção em lote, a fim de criar um conjunto de vídeos curtos em vez de clipes isolados. Para a referência completa de parâmetros de todos os três endpoints seedance-2.5, consulte o guia completo da API.

Por que conteúdo de vídeo curto combina com texto para vídeo

As plataformas de vídeos curtos não exigem duração de cinema — elas precisam de um suprimento constante de clipes de 6 a 15 segundos que façam loop sem cortes e capturem o espectador em um segundo. O seedance-2.5/text-to-video se encaixa perfeitamente nessa necessidade:

• Cada clipe pode ter até 30 segundos, com suporte a sete proporções de tela, incluindo 9:16 para TikTok/Reels/Shorts.
• Sincronização de áudio nativa — o modelo gera sons ambiente e pistas de áudio a partir das ações no prompt, em vez de produzir um clipe mudo para você dublar depois.
• Prompts em 11 idiomas, útil se você está localizando campanhas de vídeos curtos.
• Duas resoluções (480p e 720p), para que você possa gerar rascunhos com baixo custo e pagar a tarifa de 720p apenas pelos clipes que realmente serão publicados.

Um clipe real, do início ao fim

Este é um clipe que geramos para este guia: close-up de latte art sendo despejada, enquadramento vertical, para um vídeo curto de cafeteria.

O prompt exato que enviamos, sem edições:

A mão firme do barista despeja leite vaporizado de uma jarra de aço inoxidável em uma xícara de cerâmica branca de espresso, o fluxo de leite se dobra em um redemoinho de latte art rosetta que se forma em tempo real, luz dourada da hora mágica incide obliquamente sobre o balcão, croissants e doces suavemente desfocados ao fundo, composição vertical em close-up, vapor delicado, som ambiente de cafeteria.

Parâmetros: aspect_ratio: "9:16", resolution: "720p", duration: 8. A saída acima é um resultado de tarefa real e não editado — 8,06 segundos, com o som do despejo e o zumbido ambiente da cafeteria gerados diretamente pelo modelo, não adicionados na pós-produção.

Fluxo de trabalho da API

O seedance-2.5/text-to-video funciona pela API de tarefas assíncronas da hiapi — envio, polling, download. Não há endpoint síncrono de vídeo; cada clipe é uma tarefa em segundo plano.

import time
import requests

API_KEY = "YOUR_HIAPI_KEY"
BASE = "https://api.hiapi.ai/v1"

def generate_clip(prompt: str, aspect_ratio: str = "9:16",
                   resolution: str = "720p", duration: int = 8) -> str:
    submit = requests.post(
        f"{BASE}/tasks",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "seedance-2.5/text-to-video",
            "input": {
                "prompt": prompt,
                "aspect_ratio": aspect_ratio,
                "resolution": resolution,
                "duration": duration,
            },
        },
        timeout=30,
    )
    task_id = submit.json()["data"]["taskId"]

    while True:
        poll = requests.get(
            f"{BASE}/tasks/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
            timeout=30,
        ).json()["data"]
        if poll["status"] == "success":
            return poll["output"][0]["url"]   # link temporário — baixe imediatamente
        if poll["status"] == "fail":
            raise RuntimeError(poll)
        time.sleep(5)

clip_url = generate_clip(
    "A mão firme do barista despeja leite vaporizado de uma jarra de aço inoxidável "
    "em uma xícara de cerâmica branca de espresso, o fluxo de leite se dobra em um "
    "redemoinho de latte art rosetta que se forma em tempo real, luz dourada da hora "
    "mágica incide obliquamente sobre o balcão, croissants e doces suavemente "
    "desfocados ao fundo, composição vertical em close-up, vapor delicado, som ambiente de cafeteria."
)

# A URL de saída expira (tem timestamp expireAt) — baixe imediatamente e
# persista no seu próprio armazenamento; não a mantenha como hotlink
video_bytes = requests.get(clip_url, timeout=60).content
open("clip.mp4", "wb").write(video_bytes)

A resposta da tarefa nunca devolve seu prompt original — retorna apenas model, status, output e timestamps — então, se precisar reproduzir ou variar um clipe depois, registre você mesmo o que foi enviado.

Preços: duas faixas, sem 1080p

Verificado em tempo real com base no endpoint de preços da hiapi — o seedance-2.5/text-to-video é cobrado por segundo de saída, com duas faixas de resolução e sem opção de 1080p:

Resolução	Preço por segundo	Clipe de 8 segundos
480p	$0.1395	cerca de $1.12
720p	$0.3019	cerca de $2.42

O preço por segundo em 720p é cerca de 2,2 vezes o de 480p — vale a pena gerar rascunhos em 480p primeiro e pagar por 720p apenas quando o prompt estiver refinado. Os detalhes completos de parâmetros e preços estão na página do modelo seedance-2.5/text-to-video; as tarifas são válidas até 2026-08 e podem mudar, então consulte essa página antes de orçar grandes volumes.

Produza um conjunto de vídeos curtos, não apenas um clipe

Um clipe isolado é só uma demonstração; um calendário de conteúdo exige produção em lote. Trate cada clipe como uma tarefa idempotente com chave baseada no prompt, para que uma nova execução após uma falha não cobre duas vezes:

import hashlib

PROMPTS = [
    "O barista despeja leite vaporizado na xícara de espresso, a rosetta de latte art se forma, luz da hora dourada, composição vertical em close-up.",
    "Vapor subindo enquanto café coado fresco pinga pelo filtro de papel, luz da manhã atravessando a janela da cafeteria, composição vertical.",
    "Uma mão bate levemente um saco de grãos de café sobre uma balança de madeira, os grãos se acomodam, atmosfera suave de cafeteria, composição vertical em close-up.",
]

def job_key(prompt: str) -> str:
    return hashlib.sha1(prompt.encode()).hexdigest()[:12]

results = {}
for prompt in PROMPTS:
    key = job_key(prompt)
    if key in results:          # já gerou neste ciclo
        continue
    results[key] = generate_clip(prompt, resolution="480p", duration=6)
    # persista cada resultado imediatamente — veja o passo de download acima

Gere o conjunto inteiro primeiro em 480p, avalie quais clipes realmente servem à campanha e então regenere em 720p apenas os vencedores. Quando você precisa de produção em lote em vez de peças únicas, esse hábito de duas rodadas é a maior alavanca de custo.

Comparação com o Seedance 2.0

Se você já usou o Seedance 2.0, a camada de texto para vídeo do 2.5 mantém a mesma forma de tarefa de enviar-consultar-baixar — nada muda do lado da integração. As diferenças práticas que vale conhecer antes de migrar o pipeline: o 2.5 adiciona sincronização de áudio nativa a cada clipe por padrão, e sua escada de resoluções é mais simples (apenas 480p/720p, enquanto o 2.0 tem faixas adicionais). Se o seu fluxo de trabalho depende de uma resolução que o 2.5 não oferece, consulte a própria página desse modelo para ver as especificações atuais antes de assumir equivalência.

Perguntas frequentes

O seedance-2.5/text-to-video suporta 1080p? Não — até 2026-08, o modelo oferece apenas 480p e 720p. Se você precisa de saída em 1080p, procure no catálogo de modelos um modelo que ofereça suporte antes de construir um pipeline em torno deste endpoint.

O áudio é real ou precisa ser adicionado separadamente? Ele é gerado pelo modelo como parte da tarefa — o som do despejo e o zumbido ambiente da cafeteria no clipe de demonstração acima não foram adicionados na pós-produção. Se você precisa de música ou dublagem específicas da marca, ainda pode sobrepor seu próprio áudio depois.

Quanto tempo leva para gerar um clipe? O tempo de conclusão da tarefa varia com a duração e a resolução; em termos gerais, de um a alguns minutos por clipe, e sempre faça polling em vez de presumir um tempo de espera fixo.

Posso reutilizar o mesmo prompt em proporções de tela diferentes para plataformas diferentes? Sim — aspect_ratio é um parâmetro separado do prompt, então o mesmo prompt pode ser reenviado em 9:16 para TikTok/Reels e em 16:9 para YouTube sem reescrever a descrição da cena.

E se a URL de saída expirar antes de eu baixar? Você precisará reenviar a tarefa — output[0].url é um link temporário vinculado a um timestamp expireAt, não armazenamento permanente. Baixe e persista cada clipe assim que a tarefa reportar success.

Pontos principais

• seedance-2.5/text-to-video é o endpoint de prompt-entrada, clipe-saída para conteúdo de vídeos curtos — escolha 480p para rascunhos e conteúdo de preenchimento social, e 720p quando o clipe for o ativo final.
• Orce por duração, não por clipe: o custo por segundo em 720p é cerca de 2,2 vezes o de 480p, então um clipe de 8 segundos em 720p já custa cerca de $2.42.
• As URLs de saída das tarefas expiram — baixe e persista em armazenamento permanente imediatamente após o polling retornar sucesso.
• A sincronização de áudio nativa significa que conteúdo de preenchimento para vídeos curtos geralmente não precisa de dublagem ou tratamento de efeitos sonoros separado.
• O modelo atualmente não tem faixa 1080p — consulte a página do modelo antes de construir um pipeline que presuma essa faixa.

Pronto para experimentar? Acesse a página do modelo seedance-2.5/text-to-video para ver a referência completa de parâmetros, ou navegue pelo catálogo completo de modelos de vídeo da hiapi para compará-lo com opções de imagem para vídeo como o Kling 3.0 Turbo e se preparar para o seu próximo lote de vídeos curtos.