HiAPI
Blogue

Guia de uso

Guia de integração do Seedance 2.5 Flash para texto-para-vídeo: parâmetros, cobrança por segundo e práticas de engenharia

De uma requisição ao lançamento estável: como definir parâmetros e calcular custos

Nov 17, 2026
Sobre um fundo de carvão quente, uma ampla faixa de luz âmbar atravessa diagonalmente, com bordas nítidas e um espaço em branco contido no conjunto.
Modelo
seedance-2.5-flash
Nesta página

O que este modelo faz

seedance-2.5-flash/text-to-video é um modelo de texto-para-vídeo da ByteDance: recebe um prompt de texto e gera um vídeo com áudio sincronizado. Ele tem apenas esse caminho de entrada — não aceita imagens ou vídeos como entrada condicional, nem realiza compreensão de vídeo.

Os cenários adequados são "gerar um pequeno vídeo utilizável a partir de uma frase": produção em lote de materiais de marketing, planos de ambiente e atmosfera para vídeos curtos de produtos, preenchimento de trechos no banco de conteúdo e pré-visualização rápida de direções criativas. Se o seu ponto de partida é uma imagem, o caminho de imagem-para-vídeo é mais direto; se você precisa manter a consistência do sujeito com base em material de referência, use o caminho orientado por material de referência.

Quais parâmetros existem na requisição

  • prompt (obrigatório): cenário, sujeito, movimento de câmera e ação. Máximo de 5000 caracteres.
  • resolution: 480p ou 720p, padrão 480p.
  • duration: inteiro de 4 a 30, padrão 5, em segundos.
  • aspect_ratio: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive, padrão adaptive (o modelo escolhe a proporção com base no prompt).
  • output_format: mp4 (padrão) ou mov.
  • generate_audio: padrão true, gera diálogos, efeitos sonoros e som de fundo sincronizados com a imagem.

Exceto o prompt, todos têm valores padrão; a requisição mínima precisa apenas de prompt. O corpo da requisição passa por validação estrita: campos não declarados enviados em excesso são rejeitados, em vez de descartados silenciosamente — isso faz com que erros apareçam no momento do envio durante a integração, e não depois da cobrança.

Como é a cobrança por segundo

A base de cálculo é "preço unitário por segundo × segundos de saída", vinculada à faixa de resolução:

  • 480p: $0.0679/segundo
  • 720p: $0.1525/segundo

Os segundos de saída correspondem ao duration da requisição, sem arredondamentos inesperados. Exemplos: 480p com 5 segundos custa $0.3395; 720p com 5 segundos custa $0.7625; 480p com 30 segundos custa $2.037; 720p com 30 segundos custa $4.575. Dobrar a duração dobra o custo, sem desconto de "quanto mais longo, mais barato".

Isso significa três coisas: primeiro, a estimativa de orçamento é só multiplicação — defina primeiro a duração de cada vídeo e depois multiplique pela quantidade; segundo, repetir tentativas é pagar de novo, então retentativas de falha precisam de limite; terceiro, não gere vídeos longos de uma vez — divida em vários trechos curtos, gere cada um separadamente e depois faça a montagem, o que economiza dinheiro e faz com que uma falha afete apenas o trecho com problema.

Forma de integração: tarefa assíncrona

A geração de vídeo é uma tarefa demorada e a interface é assíncrona: após o envio, obtenha o identificador da tarefa, depois consulte por polling ou aguarde callback para obter o resultado e, por fim, baixe o produto e persista no banco. Não a encapsule como RPC síncrono bloqueando a requisição do usuário.

  • Máquina de estados persistida: armazene no banco o identificador da tarefa, o estado e os parâmetros da requisição; não os deixe apenas na memória do processo — perder tarefas ao reiniciar equivale a gastar dinheiro sem resultado.
  • Backoff no polling: comece com intervalos curtos, aumente gradualmente e adicione jitter; ao mesmo tempo, defina um timeout total por tarefa, e ao ultrapassá-lo vá para o ramo de falha em vez de fazer polling infinito.
  • Classificação de erros: erros de parâmetro e violações de conteúdo são falhas determinísticas, e retentar não faz sentido; apenas erros transitórios como instabilidade de rede e rate limit merecem retentativa com backoff.
  • Idempotência: inclua uma chave única de negócio no lado do envio, para evitar que cliques repetidos do usuário gerem várias tarefas e cobranças duplicadas.

Como escrever prompts estáveis

Escreva em quatro segmentos — "sujeito → sequência de ações → ambiente e iluminação → câmera" —, o que é bem mais estável do que empilhar uma série de adjetivos.

sujeito: um gato branco sentado no parapeito da janela, contraluz
movimento: do repouso até erguer a cabeça e olhar pela janela, cauda balançando lentamente
ambiente e iluminação: luz quente da tarde, profundidade de campo rasa, atmosfera silenciosa de interior
câmera: plano médio, câmera fixa, leve sensação de mão livre

Três disciplinas: cada prompt deve descrever apenas um plano contínuo, não enfie várias trocas de cena em uma única geração; versione os prompts e altere apenas uma variável por vez, para poder julgar qual mudança fez efeito; primeiro faça amostras pequenas e depois em lote, não use o lote para validar um prompt ainda indefinido.

Proporção de tela e linguagem de câmera podem ser descritas em linguagem natural — o modelo não tem um parâmetro separado de "movimento de câmera"; escrever isso no prompt é mais confiável do que esperar por um campo que não existe.

Caminho de lançamento

  1. Validar o fluxo: três prompts cobrindo cenários típicos, confirmando que envio, polling e download funcionam de ponta a ponta, sem avaliar ainda a qualidade do resultado.
  2. Definir prompts e durações: fixe um pequeno conjunto de prompts, compare os resultados de diferentes formas de escrita e diferentes durações, registre o custo de cada um e forme uma biblioteca de templates reutilizáveis.
  3. Lançamento gradual: aumente o volume proporcionalmente, observe taxa de sucesso, tempo médio, taxa de retentativa e curva de custos; só aumente mais quando os três indicadores estiverem dentro da meta.
  4. Operação contínua: revise periodicamente a biblioteca de templates, elimine formas de escrita ineficientes e acompanhe a tendência de custos e os limites de retentativa.

A página do modelo tem as especificações de parâmetros e os preços mais recentes; basta conferir antes da integração.

Artigos relacionados

Ver todos os artigos →

Comece a criar com artefactos de IA persistentes

Obtenha a sua chave de API e chame modelos de imagem, vídeo e áudio através de uma única API baseada em tasks.

Ler a documentação da API