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
- 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
-1para automático; padrão 5. - resolution:
480pou720p, padrão480p. - aspect_ratio: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, ou
adaptivepara seguir os materiais de referência; padrãoadaptive. - omni_reference_task_type: fixo em
reference(valor padrão, pode ser omitido). - output_format:
mp4(padrão) oumov; generate_audio: padrãotrue, 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 →-
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 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