Skip to main content
POST

Autorização

string
obrigatório
Todos os endpoints da API exigem autenticação via Bearer TokenObtenha sua API Key:Acesse a página de gerenciamento de API Keys para obter sua API KeyAdicione-a ao cabeçalho da requisição:

Parâmetros da requisição

string
obrigatório
Nome do modelo de geração de vídeoModelos suportados:
  • seedance-1-0-pro-fast — versão rápida, geração ágil, adequada para pré-visualização e iteração
  • seedance-1-0-pro-quality — versão de alta qualidade, tempo de geração maior e melhor qualidade
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de vídeo.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Descrição do conteúdo do vídeoDescreva cenas, ações e estilos em detalhes para obter melhores resultados de geraçãoExemplo: "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand"
integer
padrão:"5"
Duração do vídeo (segundos)Faixa suportada: 2 a 12 segundosPadrão: 5
string
padrão:"16:9"
Proporção do vídeoOpções:
  • 16:9 — paisagem
  • 9:16 — retrato
  • 1:1 — quadrado
  • 4:3 — proporção tradicional
  • 3:4 — proporção tradicional vertical
  • 21:9 — ultrawide
Padrão: 16:9
string
padrão:"1080p"
Resolução do vídeoOpções:
  • 480p — definição padrão
  • 720p — alta definição
  • 1080p — Full HD
Padrão: 1080p
integer
Inteiro de seed para controlar a aleatoriedade do conteúdo geradoFaixa de valores: inteiro entre -1 e 2^32-1
  • Para a mesma requisição, se o modelo receber valores de seed diferentes (por exemplo, não especificar o seed ou defini-lo como -1, que usará um número aleatório), serão gerados resultados diferentes
  • Para a mesma requisição, se o modelo receber o mesmo valor de seed, serão gerados resultados semelhantes, mas não há garantia de que sejam idênticos

Combinações de resolução e proporção

array
Array de imagens com papéis para um controle mais precisoExemplo:
  • Apenas uma imagem por papel é suportada
  • last_frame é suportado apenas pela versão seedance-1-0-pro-quality; a versão fast não suporta primeiro e último frame juntos

Resposta

integer
Código de status da resposta, 200 em caso de sucesso
array
Array de dados da resposta

Casos de uso

Caso 1: Vídeo em paisagem para pré-visualização rápida

Caso 2: Vídeo curto vertical de alta qualidade

Caso 3: Efeito de transição dinâmica (primeiro/último frame)

Consultar resultados da tarefaA geração de vídeo é uma tarefa assíncrona que retorna um task_id ao ser enviada. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.