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-5-pro — versão 1.5 Pro, suporta geração de áudio e primeiro/último frame
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: 4 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:"720p"
Resolução do vídeoOpções:
  • 480p — definição padrão
  • 720p — alta definição
  • 1080p — Full HD
Padrão: 720p
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
boolean
padrão:"true"
Se deve gerar áudioQuando definido como true, o vídeo incluirá áudio gerado por IA acompanhando-oPadrão: true
A geração de áudio é compatível apenas com a série Seedance 2.0 e o Seedance 1.5 Pro
boolean
padrão:"false"
Se deve fixar a câmeraQuando definido como true, a posição da câmera permanece fixaPadrão: false

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

array<url>
Array de URLs de imagem para geração imagem-para-vídeoRegras de atribuição automática de papel:
  • 1 imagem = primeiro frame
  • 2 imagens = primeiro frame + último frame
Exemplo: ["https://example.com/first.png", "https://example.com/last.png"]
  • image_urls e image_with_roles não podem ser usados em conjunto
array
Array de imagens com papéis para um controle mais precisoExemplo:
  • image_urls e image_with_roles não podem ser usados em conjunto
  • Apenas uma imagem de primeiro frame e uma de último frame são suportadas

Resposta

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

Casos de uso

Caso 1: Texto-para-vídeo com áudio

Caso 2: Vídeo curto vertical de alta qualidade

Caso 3: Vídeo dinâmico a partir do primeiro frame

Caso 4: Efeito de transição com 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.

Diferenças em relação à versão 1.0