HiAPI
Blogue

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

Nov 17, 2026
Stacked sheets receding into shallow depth of field, cream and graphite with one terracotta sheet as accent.
Modelo
seedance-2.5-flash
Nesta página

O que este modelo faz

seedance-2.5-flash/reference-to-video é o modelo de vídeo do ByteDance orientado por materiais de referência. Você fornece imagens de referência e áudios de referência, referencia-os em ordem no prompt com @image1 e @audio1, e o modelo gera um novo vídeo com base neles. As imagens de referência determinam a aparência de personagens, produtos ou cenários; os áudios de referência fornecem o ritmo, a trilha sonora ou a narração.

Restrições dos materiais de referência

  • Imagens de referência: no máximo 10, nos formatos jpeg, png, webp, bmp, tiff, gif, cada uma com menos de 30 MB, lado entre 300 e 6000 pixels, proporção entre 0.4 e 2.5; SVG, HEIC e HEIF não são suportados.
  • Áudios de referência: no máximo 5 trechos, em wav ou mp3, com menos de 15 MB, cada trecho entre 2 e 30 segundos, total não superior a 30 segundos; é possível enviar apenas áudio, sem imagens.

É necessário fornecer pelo menos um dos dois tipos de material, caso contrário a requisição não é válida.

Regras de cobrança

Esta rota cobra pelos segundos do vídeo de saída; imagens e áudios de referência não entram na contagem de segundos cobrados:

  • 480p: $0.0679/segundo, um vídeo de 5 segundos custa cerca de $0.34.
  • 720p: $0.1525/segundo, um vídeo de 5 segundos custa cerca de $0.76.

Se a duração for um inteiro de 4 a 30, a cobrança usa os segundos informados; se for -1 (automático), cobra-se pela duração real do vídeo arredondada, com mínimo de 4 segundos. Para controlar o orçamento, informe um número fixo de segundos.

Parâmetros da requisição

  • prompt (obrigatório): descreve como usar os materiais, referenciando-os em ordem com @image1, @audio1, com no máximo 5000 caracteres.
  • reference_image_urls / reference_audio_urls: arrays de URLs das imagens e dos áudios de referência.
  • duration: inteiro de 4 a 30, ou -1 para automático; padrão 5.
  • resolution: 480p ou 720p, padrão 480p.
  • aspect_ratio: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, ou adaptive para seguir os materiais de referência; padrão adaptive.
  • omni_reference_task_type: fixo em reference (valor padrão, pode ser omitido).
  • output_format: mp4 (padrão) ou mov; generate_audio: padrão true, gera diálogos, efeitos sonoros e som de fundo sincronizados.

Como escrever o prompt

Primeiro numere os materiais na ordem em que aparecem, depois explique item por item o que cada material representa e como a cena final deve ficar. Exemplo:

O produto em @image1 é colocado sobre uma mesa de madeira e gira lentamente para exibição, o fundo é a janela ao amanhecer de @image2,
a câmera avança lentamente de um plano médio para um close-up, o ritmo da cena acompanha a batida de @audio1, mantendo o brilho metálico do produto inalterado.

Com várias imagens de referência, especificar qual é o sujeito e qual é o cenário ou o estilo é muito mais estável do que escrever apenas "consulte estas imagens". Se usar áudio de referência, indique com qual trecho do áudio o movimento da cena deve coincidir.

Perguntas frequentes

  • Requisição recusada por falta de material: é preciso fornecer pelo menos uma imagem de referência ou um áudio de referência.
  • A imagem de referência não é enviada: verifique primeiro se o formato está na lista suportada, se o lado em pixels está entre 300 e 6000 e se a proporção está entre 0.4 e 2.5.
  • Áudio recusado: cada trecho deve ter entre 2 e 30 segundos e menos de 15 MB; a soma de vários trechos não pode passar de 30 segundos.
  • Custo diferente do esperado: verifique se foi usada duração automática -1; a duração automática cobra pelos segundos reais do vídeo.

Recomendações para o lançamento

Primeiro execute uma requisição com uma imagem de referência, 5 segundos e 480p para confirmar o fluxo e o critério de cobrança; depois execute outra com áudio de referência ou várias imagens de referência e verifique se a cena usou os materiais conforme a numeração do prompt. Guarde o registro dessas duas requisições como linha de base para comparar quando alterar o prompt ou os materiais. Os parâmetros e preços estão sujeitos à descrição atual da 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