Skip to main content
POST

Autenticação

string
obrigatório
Todas as interfaces exigem autenticação por meio de Bearer TokenObter a chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAo usar, adicione no cabeçalho da requisição:

Parâmetros da requisição

string
obrigatório
Nome do modelo de geração de vídeoModelos suportados:
  • kling-3.0-turbo - Kling 3.0 Turbo
string
obrigatório
Prompt de textoO limite upstream é de no máximo 3072 caracteres, recomenda-se não exceder 2500 caracteres.Exemplo: "Um corgi correndo na praia, cinematográfico, luz do entardecer"
string
Suporta URL de imagem ou Base64.
Limites upstream da imagem do primeiro quadro:
  • Formato: .jpg / .jpeg / .png
  • Tamanho: ≤ 50MB
  • Largura/altura: ≥ 300px
  • Proporção: 1:2.5 ~ 2.5:1
string
padrão:"16:9"
Proporção do vídeoValores possíveis:
  • 16:9 - Horizontal
  • 9:16 - Vertical
  • 1:1 - Quadrado
Valor padrão: 16:9
Válido apenas para texto para vídeo. No caso de imagem para vídeo, este campo não tem efeito; a proporção do vídeo é determinada pela imagem do primeiro quadro.
string
padrão:"720p"
Resolução do vídeoValores possíveis:
  • 720p
  • 1080p
Valor padrão: 720p
integer
padrão:"5"
Duração do vídeo (segundos)Faixa de valores: 3-15 (mínimo de 3 segundos, máximo de 15 segundos)Valor padrão: 5⚠️ Atenção: deve ser inserido apenas um número (como 6), sem aspas, caso contrário ocorrerá um erro
boolean
Se deve adicionar marca d’águaSó é enviado ao upstream quando passado explicitamente; se não for passado, nenhuma marca d’água é adicionada.

Texto para vídeo vs Imagem para vídeo

O sistema determina automaticamente o modo de geração com base em se first_frame_image é fornecido: com imagem de primeiro quadro segue o modo imagem para vídeo, sem imagem de primeiro quadro segue o modo texto para vídeo, sem necessidade de declaração explícita pelo usuário.

Resposta

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

Cenários de uso

Cenário 1: Texto para vídeo (1080P)

Cenário 2: Texto para vídeo (vertical 720P)

Cenário 3: Imagem para vídeo (imagem do primeiro quadro)

Cenário 4: Imagem para vídeo apenas com o primeiro quadro (sem prompt)

Cenário 5: Múltiplas tomadas em sequência (texto para vídeo)

Consultar o resultado da tarefaA geração de vídeo é uma tarefa assíncrona; após a submissão, um task_id é retornado. Use a interface obter status da tarefa para consultar o progresso e o resultado da geração.