Skip to main content
POST

Autenticação

string
obrigatório
Todas as requisições exigem autenticação via Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione o seguinte cabeçalho em cada requisição:

Parâmetros da requisição

string
obrigatório
Nome do modelo: kling-v3-motion-control ou kling-v2-6-motion-control
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
Prompt de texto descrevendo o movimento desejado, os movimentos de câmera e o estiloOpcional, mas recomendado — descrições mais específicas produzem resultados mais estáveisExemplo: "The character dances following the reference video, smooth motion, realistic style"
string
obrigatório
URL da imagem de referênciaDeve ser um link publicamente acessível
string
obrigatório
URL do vídeo de referênciaDeve ser um link direto e publicamente acessível; recomendado mp4/mov, abaixo de 100MB
O servidor analisa a duração real de video_url. O mínimo é 3 segundos; o máximo é determinado por character_orientation.
string
padrão:"yes"
Define se a trilha de áudio original do vídeo de referência deve ser mantidaOpções:
  • yes: Manter o áudio original (padrão)
  • no: Não manter o áudio original
string
obrigatório
Controle de orientação do personagemOpções:
  • image: Usa a orientação do personagem da imagem de referência (duração do vídeo de referência: 3~10s)
  • video: Usa a orientação do personagem do vídeo de referência (duração do vídeo de referência: 3~30s)
string
obrigatório
Modo de geraçãoOpções:
  • std: Modo padrão (equilíbrio entre velocidade e qualidade)
  • pro: Modo de alta qualidade (latência maior)
object
Objeto de controle de marca d’água (opcional)

Regras de duração

A duração para cobrança é determinada pela duração real analisada pelo servidor a partir de video_url, e não por uma estimativa do lado do cliente.

Resposta

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

Exemplos

Exemplo 1: orientação por imagem (até 10s)

Exemplo 2: orientação por vídeo (até 30s)