> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Controle de movimento Kling V3.0

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.

<Tip>
  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](/pt/docs/models/reference-get-async-task-result) e recuperar o resultado gerado.
</Tip>

## Cabeçalhos da solicitação

<ParamField header="Content-Type" type="string" required={true}>
  Valores enumerados: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticação Bearer: Bearer \{\{API Key}}.
</ParamField>

## Corpo da solicitação

<ParamField body="image" type="string" required={true}>
  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.
</ParamField>

<ParamField body="video" type="string" required={true}>
  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.
</ParamField>

<ParamField body="prompt" type="string">
  Prompt positivo com descrição da cena, estilo, iluminação etc.; comprimento máximo de 2500 caracteres.

  Limite de comprimento: 0 - 2500
</ParamField>

<ParamField body="model_name" type="string" required={true} default="kling-v3-0-std">
  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`
</ParamField>

<ParamField body="negative_prompt" type="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
</ParamField>

<ParamField body="keep_original_sound" type="boolean" default={true}>
  Se deve manter o áudio original do vídeo de referência.
</ParamField>

<ParamField body="character_orientation" type="string" required={true}>
  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`
</ParamField>

## Informações da resposta

<ResponseField name="task_id" type="string" required={true}>
  Use o task\_id para solicitar a [API de consulta de resultado da tarefa](/pt/docs/models/reference-get-async-task-result) e recuperar a saída gerada.
</ResponseField>