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
- 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:
480pou720p, padrão480p. - 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ãoadaptive(o modelo escolhe a proporção com base no prompt). - output_format:
mp4(padrão) oumov. - 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
- 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.
- 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.
- 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.
- 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 →-
Guia de uso
Guia de integração do Seedance 2.5 Flash para geração de vídeo a partir de materiais de referência: imagens de referência, áudio de referência e regras de cobrança
-
Guia de uso
Guia de integração do Seedance 2.5 Flash image-to-video: primeiro frame, último frame e cobrança por segundo
Faça uma imagem se mover: parâmetros, preços e causas comuns de falha
-
Guia de uso
Guia de introdução ao kling-image-4.0: pontos-chave de integração da API de geração de imagens e controle de custos
Decisões de integração e lista de verificação prática para desenvolvedores