Pular para o conteúdo principal
POST
/
v3
/
async
/
kling-v3.0-motion-control
Controle de movimento Kling V3.0
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/kling-v3.0-motion-control \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "image": "<string>",
  "video": "<string>",
  "prompt": "<string>",
  "model_name": "<string>",
  "negative_prompt": "<string>",
  "keep_original_sound": true,
  "character_orientation": "<string>"
}
'
{
  "task_id": "<string>"
}
A ferramenta de controle de movimento Kling V3.0 pode extrair trajetórias de movimento de um vídeo de referência e aplicá-las a uma imagem de referência para gerar um vídeo, mantendo a consistência do sujeito. Suporta os modos padrão e profissional, com cobrança por segundo.
Esta é uma API assíncrona que retorna apenas o task_id da tarefa assíncrona. Você deve usar esse task_id para solicitar a API de consulta de resultado da tarefa e recuperar o resultado gerado.

​
Cabeçalhos da solicitação

​
Content-Type
string
obrigatório
Valores enumerados: application/json
​
Authorization
string
obrigatório
Formato de autenticação Bearer: Bearer {{API Key}}.

​
Corpo da solicitação

​
image
string
obrigatório
URL da imagem de referência ou imagem codificada em base64; compatível com .jpg, .jpeg, .png. O tamanho do arquivo de imagem não deve exceder 10MB; largura e altura devem ser >= 300px; a proporção deve estar entre 1:2.5 e 2.5:1.
​
video
string
obrigatório
URL do vídeo de movimento de referência; compatível com .mp4, .mov. O tamanho do arquivo de vídeo não deve exceder 10MB; largura e altura devem ser >= 300px; duração de 3 a 30 segundos.
​
prompt
string
Prompt positivo com descrição da cena, estilo, iluminação etc.; comprimento máximo de 2500 caracteres.Limite de comprimento: 0 - 2500
​
model_name
string
padrão:"kling-v3-0-std"
obrigatório
Nome do modelo. kling-v3-0-std: modo padrão, com ótimo custo-benefício; kling-v3-0-pro: modo profissional, com melhor qualidade de vídeo.Valores opcionais: kling-v3-0-std, kling-v3-0-pro
​
negative_prompt
string
Prompt negativo, descrevendo os elementos que devem ser evitados no vídeo gerado; comprimento máximo de 2500 caracteres.Limite de comprimento: 0 - 2500
​
keep_original_sound
boolean
padrão:true
Se deve manter o áudio original do vídeo de referência.
​
character_orientation
string
obrigatório
Modo do quadro de saída:
  • image: prioriza a pose e a composição do personagem na imagem de referência, transferindo o movimento para o personagem da imagem (saída de 5 segundos)
  • video: prioriza a pose e a composição do personagem no vídeo de referência, aplicando o movimento do vídeo ao personagem da imagem (a duração da saída é igual à do vídeo de referência, no máximo 30 segundos)
Valores opcionais: image, video

​
Informações da resposta

​
task_id
string
obrigatório
Use o task_id para solicitar a API de consulta de resultado da tarefa e recuperar a saída gerada.