Seedance 2.0@ext 短视频：fluxo de trabalho de API prático para vídeos sociais curtos

Hoje em dia, a maior parte da descoberta de conteúdo social acontece em vídeos curtos, e um vídeo vertical bem-acabado geralmente significa filmar, editar ou ambos. O seedance-2.0@ext no hiapi pula essas etapas: escreva um prompt detalhado, chame um endpoint da API e, em alguns minutos, receba de volta um vídeo 9:16 finalizado — com áudio.

Este guia prático usa um vídeo curto realmente gerado para explicar todo o fluxo de trabalho do início ao fim: como o prompt é estruturado, como a chamada da API de tarefas assíncronas funciona na prática, quanto custou e onde o preço deixa de corresponder às suas expectativas.

Por que escolher seedance-2.0@ext para vídeos curtos

seedance-2.0@ext é a rota ext da família de modelos seedance-2.0 no hiapi — uma rota independente, com preços e conjunto de parâmetros próprios, diferente da rota padrão seedance-2.0. Ele foi criado para saídas verticais e nativas para redes sociais: enquadramento nativo em 9:16, movimentos de câmera que ficam bons na tela do celular e áudio produzido na mesma geração do vídeo, em vez de adicionado depois.

Essa combinação — enquadramento vertical mais áudio nativo — é justamente o motivo de ele ser adequado para vídeos curtos no estilo TikTok e Reels, em vez de usar um modelo de vídeo genérico e depois cortar e colocar trilha sonora por conta própria.

O prompt: o que este vídeo curto realmente usou

Geramos um vídeo de demonstração de ponta a ponta para este artigo: um close-up vertical de produto de um cold brew sendo despejado em um copo cheio de gelo, com estilo voltado para feed social. Abaixo está a saída real e o prompt original que a gerou.

Apresentação de produto em close-up vertical 9:16 voltada para feed social: um copo de vidro fosco centralizado sobre uma bancada de mármore iluminada pelo sol. A câmera se aproxima lentamente de cima para baixo sobre o copo vazio, que se enche de gelo transparente refletindo a luz da hora dourada. No segundo dois, um jato de cold brew é despejado de fora da parte superior do quadro, girando e escurecendo o gelo, e em seguida o leite se mistura em espirais suaves. Gotas escorrem pelo vidro e o vapor frio sobe contra a luz. A câmera faz um movimento lento em arco, de cima para baixo, até um ângulo baixo de três quartos, terminando em um close-up nítido com profundidade de campo rasa, com um bokeh quente vindo da janela ao fundo. Iluminação comercial natural brilhante, reflexos lustrosos, profundidade de campo rasa, estética de vídeo de produto ultralimpa, micro-movimento suave de câmera na mão, qualidade comercial premium. Áudio nativo: som suave de despejo em fio, gelo tilintando contra o vidro, leve ruído ambiente de café, sem música. Sem texto legível, sem logotipos, sem pessoas, sem mãos, sem cortes.

Resultado: 720×1280 (9:16), 24fps, cerca de 8 segundos, com áudio estéreo AAC nativo embutido no arquivo — sem necessidade de um fluxo separado de foley.

Por que este prompt funciona

Este prompt faz várias coisas que prompts mais curtos e vagos não fazem:

• Ele dá um caminho à câmera, em vez de uma imagem única. "Aproximação de cima para baixo" → "movimento lento em arco até um ângulo baixo de três quartos" → "close-up nítido" descreve o movimento ao longo de todo o vídeo curto, e não uma composição estática.
• Ele define o momento da ação. "No segundo dois, um jato de cold brew é despejado" ancora a ação de despejar em um instante específico, em vez de deixar o modelo adivinhar quando a "parte interessante" deve acontecer.
• Ele sobrepõe pistas de material e iluminação. Gotas, vapor frio, bokeh quente, reflexos lustrosos — esses detalhes fazem uma tomada de produto passar do comum para o sofisticado.
• O áudio é escrito diretamente no prompt, em vez de ser tratado como complemento posterior: som de despejo em fio, tilintar de gelo, ruído ambiente leve, e explicitamente sem música. O modelo sincroniza o som com a ação visual descrita acima.
• Ele termina com uma lista negativa. "Sem texto legível, sem logotipos, sem pessoas, sem mãos, sem cortes" bloqueia antecipadamente os modos de falha mais comuns em gerações de produtos.

Trate o prompt como um briefing criativo curto, e não como uma legenda — é aí que está a verdadeira diferença na qualidade da saída.

Reproduza com a API /v1/tasks

O seedance-2.0@ext roda pelo endpoint de tarefas assíncronas do hiapi. Você envia uma tarefa, faz polling até ela ser concluída e então extrai o vídeo da resposta.

Envio:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0@ext",
    "input": {
      "prompt": "<your prompt>",
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "duration": 8,
      "generate_audio": true
    }
  }'

prompt e aspect_ratio são obrigatórios — se você omitir aspect_ratio, a chamada falhará na validação antes de chegar à geração. resolution, duration (4–15 segundos) e generate_audio são opcionais; os valores acima são próximos da configuração usada para gerar o vídeo curto deste artigo.

Se você vem da ideia de vídeo a partir de imagem, vale um aviso: a página de preços lista tarifas de vídeo a partir de imagem para este modelo, mas o schema de entrada real aceita apenas prompts de texto — campos de imagem ou quadro de referência são rejeitados. Independentemente do rótulo de preço, na prática ele é um modelo de texto para vídeo.

Consulta do resultado:

curl https://api.hiapi.ai/v1/tasks/<task_id> \
  -H "Authorization: Bearer $HIAPI_API_KEY"

Assim que status indicar sucesso, output[0].url aponta para o .mp4 finalizado. Esse link é temporário — cerca de uma semana, conforme a janela de expiração na resposta da tarefa — então baixe os bytes imediatamente e armazene-os por conta própria, em vez de linkar diretamente para ele.

Preços: a peculiaridade do 4K

O seedance-2.0@ext é cobrado por segundo de saída, com a tarifa variando conforme a faixa de resolução:

Resolução	Preço por segundo
720p	$0.149
1080p	$0.373
2K	$0.662
4K	$0.467

Observe que, neste modelo, 4K é mais barato que 2K — $0.467/s contra $0.662/s. Não é erro de digitação nem um padrão comum; a maioria dos modelos aqui tem preço que aumenta monotonicamente com a resolução. Não presuma que outros modelos sejam assim, e revalide /api/pricing antes de codificar lógica de custo baseada em resolução no seu pipeline, porque essas faixas realmente podem ser ajustadas.

Para referência, o vídeo curto de demonstração de 8 segundos em 720p acima custou $1.19 para ser gerado — um simples cálculo de duração × tarifa por segundo na faixa de 720p.

Escolha a resolução conforme onde o vídeo curto será realmente exibido

Só o salto de 720p → 1080p já aumenta o custo em cerca de 2,5 vezes, então, antes de gerar qualquer coisa em lote, a resolução é a alavanca que vale considerar primeiro:

• Exibição em feed e Stories (TikTok, Reels, Shorts) quase sempre é vista no celular, com uma densidade de pixels que é apenas uma fração da densidade real de 1080p — 720p geralmente é indistinguível ali e é a faixa mais barata.
• 1080p vale a pena quando o vídeo curto pode ser reutilizado em um hero de landing page ou em anúncios pagos que podem ser renderizados em tamanhos maiores que a tela do celular.
• 2K e 4K são adequados para material de origem que você planeja cortar, redimensionar ou estabilizar na pós-produção — a resolução extra dá espaço para recompor sem perda visível de qualidade. Dada a tabela de preços acima, neste modelo específico, 4K é a opção mais vantajosa entre as duas.

Perguntas frequentes

O seedance-2.0@ext suporta vídeo a partir de imagem, e não apenas texto para vídeo? Não — embora a página de preços liste tarifas de vídeo a partir de imagem para este modelo, o schema real de /v1/tasks da rota ext aceita apenas prompts de texto; URLs de imagem, quadros de referência e campos de vídeo de referência são rejeitados. Até que a lista de modelos da plataforma diga o contrário, trate-o como somente texto para vídeo.

Posso controlar a duração do vídeo curto gerado? Sim, por meio do campo opcional duration, com um número inteiro de 4 a 15 segundos. Se omitido, o modelo aplica o valor padrão; se um template downstream espera um comprimento específico, é mais seguro definir explicitamente.

O vídeo já vem com áudio automaticamente? A geração de áudio nativo é fornecida pelo campo opcional generate_audio. Escrever o áudio desejado diretamente no prompt — como "som suave de despejo em fio, gelo tilintando contra o vidro, leve ruído ambiente de café" acima — faz com que ele seja sincronizado com a ação visual, sem necessidade de um fluxo de áudio separado.

O 4K é realmente mais barato que o 2K, ou é um bug de exibição? Este é o preço real atual na data de publicação deste artigo (agosto de 2026), não um bug — mas os preços por resolução podem mudar, então confirme em /api/pricing antes de depender disso no seu modelo de custos.

Por quanto tempo a URL do vídeo retornada é válida? O output[0].url de uma tarefa concluída é um link temporário, válido por cerca de uma semana, conforme os metadados de expiração da tarefa. Baixe e armazene o arquivo por conta própria, em vez de linkar para ele a longo prazo.

O que fazer a seguir

Os detalhes completos de parâmetros e os preços atuais deste modelo estão na página do modelo seedance-2.0@ext e na página de preços do hiapi. Para conhecer mais padrões de prompt em torno do mesmo modelo, Receitas de prompt do Seedance 2.0@ext tem mais exemplos, e Demonstração de produto em vídeo curto baseada no Seedance 2.0 explica como aplicar o mesmo fluxo de trabalho de tarefas assíncronas a briefings criativos diferentes.