Seedance 2.5: referências, edição e revisão de vídeos

Pedir um vídeo novo, editar um trecho e prolongar uma cena são tarefas diferentes no Seedance 2.5. Na API documentada pela BytePlus, essa diferença afeta parâmetros obrigatórios: uma edição exige ratio=adaptive e duration=-1, por exemplo. Um prompt visualmente claro ainda pode falhar quando a configuração descreve outra tarefa.

Este guia explica como organizar referências, preparar um pedido e conferir o resultado, com base nas fontes oficiais consultadas em 4 de novembro de 2026. O exemplo é fictício: um trem de brinquedo atravessando uma ponte de papelão. Nenhuma geração, chamada paga ou edição foi executada para escrever o artigo.

Modelo, produto e API: o que está documentado

A página oficial do Seedance 2.5 apresenta um modelo de geração conjunta de áudio e vídeo, com até 30 segundos por geração, referências e edição. Isso descreve o modelo; as condições de uso e os controles disponíveis dependem da plataforma pela qual ele é acessado.

O anúncio de lançamento de 31 de julho de 2026 cita Jimeng AI e Doubao Pro e, naquele momento, indicava a API como futura. Já o tutorial atual da BytePlus ModelArk documenta a API Dreamina Seedance 2.5, incluindo criação de tarefas, parâmetros e exemplos de consulta. Não use a ressalva histórica de julho como descrição automática da disponibilidade atual.

O procedimento técnico deste artigo acompanha esse tutorial da ModelArk. Ele exige conta, chave de API e ativação do modelo, com condições de contratação ou saldo descritas pela plataforma. Confira as condições efetivas da sua conta antes de habilitar recursos. Não se trata de acesso universal ou de uma proposta de gerar vídeos sem cobrança.

A documentação também aponta o console e o API Explorer como caminhos para trabalhar com modelos e parâmetros. A presença dessas opções não significa que os comandos de uma interface sejam idênticos aos de outra. Ao seguir um exemplo, identifique produto, modelo e ambiente; evite misturar uma tela do Jimeng com um parâmetro da API sem conferir a correspondência.

Identifique o tipo de tarefa antes dos parâmetros

Na documentação, o tipo de tarefa depende dos materiais enviados e da intenção do prompt. Apenas texto caracteriza text-to-video. Imagens marcadas como first_frame e, quando aplicável, last_frame definem o fluxo de primeiro quadro ou primeiro e último quadros. Referências de imagem, vídeo e áudio integram o caminho de referência multimodal.

Dentro desse último caminho, o pedido pode significar geração por referência, edição ou extensão. Se você enviar um vídeo e pedir “troque o fundo”, está formulando uma edição. Se pedir “continue a cena”, está formulando uma extensão. Escrever as duas coisas sem delimitar o objetivo torna a preparação dos parâmetros mais difícil.

O campo omni_reference_task_type permite orientar o subtipo, com valores documentados como auto, edit e extend. Mesmo ao indicar edit ou extend, o prompt precisa corresponder à escolha. O tutorial informa que uma divergência identificada durante o processamento ainda pode gerar erro assíncrono.

Prepare os arquivos de referência sem confundir quantidade e duração

O tutorial descreve até 50 referências: 30 imagens, 10 vídeos e 10 áudios. Para os vídeos, o total não pode ultrapassar 30 segundos; a mesma duração total máxima vale para os áudios de referência. Portanto, dez vídeos não significam dez clipes de 30 segundos cada.

Nas imagens, a documentação estabelece proporção entre 0,4 e 2,5, dimensões entre 300 e 6.000 pixels e arquivo menor que 30 MB. Para vídeos, ela lista limite de 200 MB por arquivo e outros requisitos de resolução, dimensões, codificação e taxa de quadros. Consulte a tabela completa quando preparar os materiais; extensão de arquivo sozinha não comprova compatibilidade.

Há uma diferença relevante de duração: em tarefas que não são edição, cada vídeo pode ter de 2 a 30 segundos; para editar, o clipe precisa ter de 4 a 30 segundos. Um vídeo de três segundos pode estar dentro do primeiro intervalo e ainda ser inadequado para a segunda tarefa. Confira o objetivo antes de tratar um arquivo como pronto.

Para o exemplo, bastariam uma imagem do trem, uma imagem da ponte e um clipe de movimento autorizado. Um vídeo de oito segundos, outro de doze e outro de onze somariam 31 segundos, acima da cota total documentada. Faça a soma antes do envio e retire trechos sem função no pedido.

O tutorial adverte que o upload direto de imagens ou vídeos de referência com rostos humanos reais não é suportado nesse fluxo e aponta soluções específicas para retratos. Não interprete autorização de uso de uma imagem como garantia de que qualquer forma de envio será aceita. O exercício com brinquedo evita essa categoria e não ensina a contornar validações.

Exemplo fictício: trem, ponte e continuidade

Imagine um vídeo de 12 segundos de um trem de madeira vermelho, com uma locomotiva e dois vagões amarelos, atravessando uma ponte de papelão. A cena é uma maquete sobre uma mesa; ninguém aparece. O objetivo é mostrar a travessia completa, mantendo quantidade de vagões, direção e aparência dos materiais.

Defina o papel dos anexos antes do roteiro. @Image 1 representa o desenho e as cores do trem. @Image 2 representa ponte, trilhos e disposição da maquete. @Video 1 orienta apenas o ritmo e o acompanhamento lateral da câmera. Os nomes ilustram as referências do exercício; precisam corresponder aos materiais efetivamente enviados em uma tarefa real.

O tutorial recomenda explicitar o que cada material fornece, como aparência ou ação, e o que não deve ser transferido. Se o vídeo de movimento mostrar um carro numa rua, por exemplo, não é esse carro que define o trem ou o cenário. Registre a função limitada do clipe, em vez de depender de uma interpretação implícita.

As marcações de tempo expressam a intenção, não um resultado comprovado. Ao revisar, confira se a ponte continua com a mesma estrutura e se nenhum vagão aparece ou desaparece. Um vídeo bonito pode descumprir a travessia completa; uma instrução escrita permite identificar essa diferença sem inventar novos critérios depois.

Traduza a intenção para uma requisição coerente

Na API descrita, content reúne o texto e os materiais. Os papéis reference_image, reference_video e reference_audio identificam referências; first_frame e last_frame têm outra finalidade. Uma imagem não passa a ser primeiro quadro apenas porque o prompt a chama de “início” se o restante da configuração descreve outro caminho.

Para uma nova geração por referência do trem, registre modelo, lista de arquivos, prompt, duração pretendida e formato. Para editar um vídeo de 12 segundos já existente, a configuração muda: indique edit, inclua o vídeo com role reference_video, use ratio adaptive e duration -1. Não mantenha duration 12 por hábito no fluxo de edição.

Esse -1 não é uma duração negativa de vídeo. Na regra documentada de edição, ele faz o modelo conservar aproximadamente a duração do clipe selecionado. O tutorial admite uma saída ligeiramente menor, com diferença de até 0,4 segundo. Por isso, compare a duração real e o último acontecimento da cena, em vez de exigir igualdade exata sem ler a ressalva.

A segurança da chave e o acesso aos arquivos são decisões de implementação. O tutorial usa URLs acessíveis para os materiais e recomenda armazená-los em serviço apropriado. Antes de tornar qualquer arquivo público, confira seu conteúdo e a finalidade do acesso. Não coloque credenciais dentro de prompts, imagens, links compartilhados ou registros públicos do projeto.

Este artigo não fornece um comando pronto para disparar uma geração. O passo útil anterior é uma conferência da requisição: a intenção corresponde ao subtipo? Os materiais têm papéis corretos? A proporção e a duração respeitam aquele fluxo? A tarefa só deve ser iniciada depois da conferência das condições e do consumo envolvidos.

Acompanhe o estado: tarefa criada ainda não significa vídeo pronto

O fluxo da ModelArk é assíncrono: a criação retorna um identificador, usado para consultar a tarefa. O exemplo oficial acompanha o estado até sucesso ou falha. Ao chegar a succeeded, o resultado fornece o endereço do vídeo; em failed, o tratamento precisa considerar o erro informado.

Para o trem fictício, registre o identificador junto ao pedido e aos arquivos usados. Isso evita confundir o resultado de uma rodada com outra. Não compartilhe um endereço como “vídeo final” apenas porque a criação da tarefa foi aceita. Primeiro confirme o estado, depois abra o material e confira a sequência produzida.

A documentação distingue validação síncrona, na submissão, de validação assíncrona, durante o processamento. Indicar edit ou extend permite antecipar algumas verificações de parâmetros. Ainda assim, a interpretação posterior do prompt pode identificar uma tarefa incompatível com o subtipo informado.

O tutorial cita InvalidParameter.TaskTypeMismatch para divergência de tipo e InvalidParameter.TaskTypeConstraint para incompatibilidade entre parâmetros e restrições da tarefa. Se aparecer um desses códigos, compare subtipo, intenção e parâmetros antes de reenviar. Não trate toda falha como motivo para gerar de novo com a mesma requisição.

Se houver limitação de taxa, registre a resposta e respeite os limites do serviço. O tutorial diferencia limites de criação, concorrência e consulta. Acompanhamento de estado não deve virar um ciclo sem controle de novas tarefas: consultar uma solicitação existente e criar outra solicitação são ações diferentes.

Edite um intervalo ou estenda a sequência

Suponha que um vídeo hipotético do trem tenha um poste de cenário que cobre o último vagão entre seis e oito segundos. Um pedido de edição poderia delimitar: “Edite @Video 1. Entre seis e oito segundos, remova apenas o poste diante da ponte. Preserve o trem, os dois vagões, a câmera e a direção da travessia”.

O anúncio oficial descreve edição orientada por timestamps. Isso fundamenta o tipo de pedido; não garante que a preservação será perfeita. Confira o trecho editado e suas bordas: a ponte muda antes dos seis segundos? O poste reaparece depois? Uma alteração localizada também precisa manter continuidade com o restante do vídeo.

Estender é outro objetivo. A continuação do trem poderia mostrar os vagões saindo da maquete e parando numa estação de papelão. Nesse caso, diga que deseja continuar o vídeo e descreva o acontecimento novo. Confira a última posição, a direção e a distância entre vagões no ponto de passagem para a extensão.

A landing menciona extensão por duas vezes, enquanto o anúncio apresenta exemplos de continuidade em múltiplas rodadas. Na API, siga as restrições atuais do tutorial e as opções exibidas, sem interpretar a narrativa promocional como duração ilimitada. Planeje cada continuação por sua função na história, não apenas para aumentar o tempo total.

Para decidir se precisa de uma extensão ou de montagem, identifique a transição desejada. Se o trem deve continuar o mesmo movimento, a passagem exige continuidade. Se a próxima cena é uma vista geral de outra estação, um corte pode fazer parte do projeto. A leitura sobre edição de vídeos para iniciantes ajuda a situar essa decisão de montagem.

A demonstração oficial relacionada compara mudanças de câmera numa animação de café da manhã. Há texto visível em chinês e comparação de imagens lado a lado. É um exemplo publicado pelo Seedance, não um passo a passo da API nem uma execução do exemplo deste artigo.

Entenda o caminho Draft e final antes de escolher duas etapas

O tutorial documenta Draft como um caminho para gerar uma prévia de 480p e avaliar estrutura, movimento e intenção antes do vídeo final. Para ativá-lo, a tarefa usa draft=true. Essa prévia é uma geração própria, com consumo; o texto oficial informa que as duas etapas são cobradas separadamente.

Depois da revisão, o identificador do Draft pode ser usado para gerar o final, atualmente em 1080p nesse procedimento. O modelo precisa ser o mesmo, e draft deve ser omitido ou false. Alguns parâmetros são reaproveitados automaticamente, como prompt, referências, duração, proporção e áudio; o tutorial adverte para não enviá-los novamente, mesmo com valores iguais.

Para a maquete, a prévia serviria para conferir se o trem atravessa inteiro e se a câmera acompanha a ação. Se essa estrutura estiver errada, não avance apenas para obter mais resolução. A decisão de corrigir o pedido e gerar outra tentativa é diferente da conversão de um Draft aprovado pelo seu processo de revisão.

A validade também importa. Para IDs de Draft criados a partir de 28 de outubro de 2026, às 10h em UTC+8, o tutorial informa 14 dias; os anteriores continuam com sete. A contagem parte de created_at. Depois do vencimento, o identificador não pode ser usado para gerar o final. Registre a data da tarefa, sem supor validade permanente.

Confira formato, compatibilidade e validade do resultado

O tutorial lista saídas mp4 e mov. Também adverte que a saída 1080p do Seedance 2.5 usa 10 bits e H.265/HEVC, com possíveis incompatibilidades em alguns ambientes. O mov tem características próprias de codificação e reprodução. Portanto, a extensão do arquivo não basta para concluir que ele tocará no navegador ou editor escolhido.

Abra o vídeo no destino previsto: se a entrega será uma página, confira ali; se será edição posterior, confira o arquivo no editor. Um problema de reprodução não deve ser confundido imediatamente com falha de geração. Verifique formato, codificação e os ambientes recomendados na documentação, preservando o material original para comparação.

A URL do vídeo fica disponível por 24 horas e tem limite documentado de 100 downloads. Outros identificadores de tarefa, fora do caso específico de Draft, têm validade de sete dias. Identificador e URL são coisas diferentes: guardar apenas o ID não significa conservar o arquivo de vídeo indefinidamente.

Planeje a transferência do resultado para o armazenamento apropriado ao projeto dentro do prazo. Registre qual arquivo corresponde a cada tarefa e preserve sua relação com o pedido revisado. Não entregue um link temporário como se fosse um endereço durável de publicação. Para preparar a inserção em conteúdos, veja também o contexto de IA no fluxo de videomakers.

Revise o vídeo que realmente será entregue

No exemplo do trem, confira quatro itens observáveis: uma locomotiva e dois vagões, travessia completa, direção da esquerda para a direita e estrutura da ponte. Observe início, trecho central e final, além de assistir à sequência inteira. Nos intervalos editados ou estendidos, acrescente a conferência das bordas.

Depois confira sons e textos. O tutorial inclui português entre os idiomas suportados, mas isso não substitui ouvir uma fala e ler cada legenda. No exercício sem pessoas e sem diálogo, confirme se não apareceu voz, texto ou música que contrarie o pedido. Uma imagem aprovada não representa aprovação automática do áudio.

O próprio anúncio reconhece limitações na plausibilidade física de movimentos complexos e em cenas com interação entre vários sujeitos. Para a maquete, procure rodas que atravessam trilhos, vagões que se fundem e alterações no apoio da ponte. A capacidade anunciada de gerar uma história não elimina a revisão do que aconteceu em cada momento.

Se precisar comparar outros processos, o guia de planejamento no Higgsfield e o de vídeos com Google Omni tratam de plataformas distintas. Mantenha o pedido do Seedance vinculado aos parâmetros e às fontes correspondentes, sem importar controles de outro produto.

Feche a rodada com um registro verificável

Uma anotação de revisão para a maquete pode dizer: “A locomotiva entra na ponte aos três segundos, mas o segundo vagão desaparece antes da saída”. Acrescente o identificador da tarefa, o intervalo observado e a referência que mostra os dois vagões. Esse registro é mais preciso do que pedir outra versão “mais realista”.

Se a falha estiver na montagem da requisição, registre o parâmetro corrigido antes de reenviar. Se a tarefa terminou com sucesso, mas a cena descumpriu o roteiro, registre o defeito visual. Os dois casos exigem decisões diferentes: corrigir uma incompatibilidade técnica ou reformular a direção e as referências.

Quando aceitar uma versão, identifique também seu arquivo de entrega, duração e local de armazenamento. Confira esse arquivo novamente depois de uma transferência ou conversão. A aprovação deve corresponder ao material que será usado, não apenas a uma prévia anterior ou à mensagem de sucesso da tarefa.

Perguntas frequentes

Seedance 2.5 é a mesma coisa que a API da ModelArk?

Seedance 2.5 é o modelo. O tutorial da BytePlus documenta seu uso pela API Dreamina Seedance 2.5 na ModelArk, com requisitos e parâmetros próprios. Não presuma que interfaces de outras plataformas tenham os mesmos controles.

Quais parâmetros são obrigatórios para editar um vídeo?

No fluxo documentado, a edição exige vídeo com role reference_video, intenção de edição no prompt, ratio=adaptive e duration=-1. O vídeo deve ter de 4 a 30 segundos. O campo omni_reference_task_type pode ser definido como edit para antecipar validações, mas o prompt também precisa corresponder à tarefa.

Posso enviar dez vídeos de trinta segundos como referências?

Não nesse limite documentado. O tutorial permite até dez vídeos de referência, mas a duração total deles não pode ultrapassar trinta segundos. Quantidade de clipes e duração somada precisam ser conferidas juntas.

O Draft é uma prévia gratuita e permanente?

Não. O tutorial informa cobrança separada para Draft e final. Draft é gerado em 480p; o final desse caminho é atualmente 1080p. Os IDs de Draft criados desde 28 de outubro de 2026, às 10h em UTC+8, valem 14 dias; os anteriores, sete.

O link do vídeo gerado pode ser usado como endereço definitivo?

Não. A documentação informa disponibilidade da URL por 24 horas e limite de 100 downloads. Planeje guardar ou transferir o resultado para o armazenamento apropriado dentro desse prazo e confira o arquivo no destino de entrega.