HiAPI
Blogue

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

Nov 17, 2026
Matriz de pontos discreta em verde-menta sobre fundo preto, com a densidade dos pontos aumentando gradualmente da esquerda para a direita.
Modelo
seedance-2.5-flash
Nesta página

O que este modelo faz

seedance-2.5-flash/image-to-video é o modelo image-to-video da ByteDance: envie uma imagem como primeiro frame e o modelo a usa como ponto de partida para gerar um vídeo contínuo, com áudio gerado em sincronia. A proporção da imagem acompanha o primeiro frame, sem recorte secundário.

Ele é adequado para cenários que partem de material determinístico: exibição dinâmica de imagens de produto, microexpressões e movimentos corporais de ilustrações de personagem, pré-visualização dinâmica de esboços de storyboard e curtas que precisam preencher um pool de conteúdo em lote. Não é adequado para a necessidade de "gerar uma narrativa completa a partir de uma única frase" — isso é tarefa da linha text-to-video.

Parâmetros da requisição

  • prompt (obrigatório): descreve a ação, o movimento de câmera, a cena e o som desejados, com até 5000 caracteres.
  • first_frame_url (obrigatório): imagem do primeiro frame. Suporta jpeg, png, webp, bmp, tiff, gif, heic, heif; cada imagem com no máximo 30 MB, de 300 a 6000 pixels por lado e proporção entre 0.4 e 2.5.
  • last_frame_url (opcional): imagem do último frame, com as mesmas restrições do primeiro frame; se as proporções forem diferentes, o alinhamento é feito por recorte centralizado. Se o último frame for enviado, o primeiro frame também deve ser enviado.
  • resolution: 480p ou 720p, padrão 480p.
  • duration: inteiro de 4 a 30, padrão 5, em segundos.
  • aspect_ratio: aceita apenas adaptive; a proporção de saída acompanha a imagem do primeiro frame.
  • output_format: mp4 (padrão) ou mov.
  • generate_audio: padrão true.

Cobrança por segundo

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

O número de segundos cobrados é igual ao duration solicitado. Alguns exemplos comuns: 480p 4 segundos $0.2716, 720p 4 segundos $0.61, 480p 10 segundos $0.679, 720p 10 segundos $1.525. As imagens de primeiro e último frame não são cobradas à parte.

Como a cobrança é por segundo, cada tentativa repetida é um novo pagamento. Avaliar "se o primeiro frame é adequado" antes de enviar é muito mais barato do que gerar e refazer depois.

O primeiro frame define o teto do resultado final

O modelo só consegue estender as informações já presentes no primeiro frame, então a qualidade do primeiro frame praticamente determina o teto do resultado:

  • O sujeito deve estar nítido e ocupar uma proporção razoável da imagem — se for pequeno demais, o modelo terá dificuldade para decidir o que deve se mover.
  • Evite desfoque forte e ruído; entradas de baixa qualidade são amplificadas em cada frame.
  • Atenção às bordas da imagem: sujeitos cortados tendem a se deformar durante o movimento.
  • Textos na imagem dificilmente se mantêm estáveis em movimento, a menos que não sejam o foco.
  • Preparar várias imagens candidatas de primeiro frame para o mesmo sujeito é mais eficaz do que ajustar repetidamente o prompt.

A duração é tanto custo quanto variável de qualidade

Quanto mais longo o trecho, mais frames o modelo precisa manter consistentes, e maior a probabilidade acumulada de deriva e distorção. Recomenda-se validar primeiro com 4 a 5 segundos se o primeiro frame e a direção do movimento funcionam; confirmado isso, alongue conforme a necessidade. Para conteúdos longos, organize com "vários trechos curtos + montagem na pós-produção", em vez de depender de uma única geração longa.

Falhas comuns e ordem de investigação

  1. Erro de parâmetro já no envio: verifique primeiro se a imagem excede limites (tamanho, lados, proporção, formato) e se foi enviado apenas last_frame_url sem o primeiro frame.
  2. Deformação do sujeito na imagem: na maioria das vezes o sujeito do primeiro frame é pequeno demais, está cortado nas bordas ou a exigência de movimento é grande demais. Troque o primeiro frame ou descreva uma ação menor.
  3. Proporção diferente do esperado: esta linha usa adaptive fixo e a saída acompanha o primeiro frame; se quiser 16:9 ou 9:16, defina isso no primeiro frame.
  4. Conteúdo bloqueado: o próprio primeiro frame também passa por revisão de conformidade; o que estiver na imagem determina diretamente se a chamada pode ser feita.
  5. O cliente expira, mas a tarefa na verdade teve sucesso: a geração de vídeo demora bastante; configurar um timeout curto demais no cliente faz tratar sucesso como falha, e reenviar gera cobrança duplicada. Trate como tarefa assíncrona e dê timeout suficiente.

Recomendações para produção

Primeiro, valide o fluxo com três a cinco primeiros frames de tipos diferentes, confirmando envio, polling e download de ponta a ponta; depois, fixe o primeiro frame e altere apenas o prompt para descobrir quais descrições de ação o modelo responde melhor; por fim, aumente o volume proporcionalmente, acompanhando taxa de sucesso, tempo médio e taxa de repetição. Parâmetros e preços estão sujeitos à descrição atual na página do modelo.

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