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
- 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:
480pou720p, padrão480p. - 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) oumov. - 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
- 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_urlsem o primeiro frame. - 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.
- Proporção diferente do esperado: esta linha usa
adaptivefixo e a saída acompanha o primeiro frame; se quiser 16:9 ou 9:16, defina isso no primeiro frame. - 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.
- 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 →-
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 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
-
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