Seedance 2.5 Flash API
Referência completa da API dos modelos de geração de vídeo Seedance 2.5 Flash da ByteDance.
Variantes do modelo
Esta API oferece três variantes:
Comparação rápida
Proporções compatíveis
As variantes de texto para vídeo e de referências para vídeo aceitam as seguintes proporções:
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
A variante de imagem para vídeo não aceita o parâmetro aspect_ratio.
Opções de resolução
Seedance 2.5 Flash Text to Video
Endpoint
POST /api/v1/video/task
Parâmetros da requisição
Obrigatórios
Opcionais
Exemplo de requisição
javascript
Seedance 2.5 Flash Image to Video
Parâmetros da requisição
Obrigatórios
Opcionais
Omita
aspect_rationas requisições de imagem para vídeo. O modelo não aceita esse parâmetro.
Exemplo de requisição
javascript
Seedance 2.5 Flash Reference to Video
Parâmetros da requisição
Obrigatórios
Mídias de referência
Todas as mídias de referência são opcionais. É possível enviar apenas imagens, apenas vídeos, apenas áudios ou nenhuma referência. Para gerar vídeos sem referências, recomenda-se a variante de texto para vídeo.
Marcadores de referência @ (AT)
O recurso de referência @ (AT) associa as mídias ao prompt por meio de marcadores numerados <<<...>>>. A numeração começa em 1 para cada tipo de mídia e segue a ordem do respectivo array:
Por exemplo, se a primeira imagem servir de referência para um personagem e a segunda para o cenário, use <<<image_1>>> para o personagem e <<<image_2>>> para o cenário em prompt. Cada marcador deve apontar para um item existente no array correspondente.
Opcionais
Exemplo de requisição
javascript
Exemplo de requisição de referências para vídeo com @ (AT)
javascript
Limites de mídia
Estes limites se aplicam às imagens do primeiro e do último quadro e às mídias de referência dos modelos desta página.
As durações totais dos áudios e dos vídeos de referência têm limites separados de 30 segundos. As quantidades também são independentes: até 10 imagens, 5 vídeos e 5 clipes de áudio.
Todos os modelos exigem resolution e duration, sem valores padrão. As variantes de texto para vídeo e de referências para vídeo usam 16:9 quando aspect_ratio é omitido. O som vem ativado por padrão (true). Use false para gerar um vídeo sem som.
Formato da resposta
Resposta inicial
Todos os modelos retornam um task_id para consultas periódicas de status:
json
Resposta à consulta de status
Consulte GET /api/v1/video/{taskId} periodicamente para verificar o status:
json
Valores de status
submitted: Tarefa aceita e aguardando processamentoprocessing: Geração do vídeo em andamentosucceed: Geração do vídeo concluídafailed: Falha na geração do vídeo
Tempo de processamento
O tempo de processamento varia conforme a duração, a resolução e as condições atuais da fila.
Consulte o status a cada 5 a 10 segundos.
Boas práticas
- Parâmetros obrigatórios: sempre informe
prompt,resolutioneduration. Nas variantes de texto para vídeo e de referências para vídeo,aspect_ratioé opcional e o padrão é16:9 - Proporção na geração a partir de imagem: omita
aspect_rationas requisições de imagem para vídeo - Vídeos de referência: os vídeos são opcionais. Respeite os limites de duração de cada vídeo e da soma de todos eles
- Imagens de referência: as imagens são opcionais, independentemente dos vídeos e áudios. Envie até 10 URLs de imagens compatíveis
- Áudios de referência: cada clipe deve durar de 2 a 30 segundos e ter até 15 MB. A duração total não pode ultrapassar 30 segundos
- Ordem das referências: organize
images,videoseaudiosna ordem desejada e faça referência aos itens no prompt seguindo essa ordem - Som: omita
soundpara usar o valor padrãotrueou defina-o comofalsepara desativar a geração de som