> ## 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.

# Control de movimiento de Kling V3.0

La herramienta de control de movimiento de Kling V3.0 puede extraer trayectorias de movimiento de un video de referencia y aplicarlas a una imagen de referencia para generar un video, manteniendo al mismo tiempo la coherencia del sujeto. Admite los modos estándar y profesional, con facturación por segundo.

<Tip>
  Esta es una API **asíncrona** que solo devolverá el task\_id de la tarea asíncrona. Debe usar ese task\_id para solicitar la [API de consulta de resultados de tareas](/es/docs/models/reference-get-async-task-result) y recuperar el resultado generado.
</Tip>

## Encabezados de solicitud

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

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticación Bearer: Bearer \{\{API Key}}.
</ParamField>

## Cuerpo de la solicitud

<ParamField body="image" type="string" required={true}>
  URL de la imagen de referencia o imagen codificada en base64; admite .jpg, .jpeg, .png.
  El tamaño del archivo de imagen no debe superar los 10 MB; tanto el ancho como la altura deben ser >= 300px; la relación de aspecto debe estar entre 1:2.5 y 2.5:1.
</ParamField>

<ParamField body="video" type="string" required={true}>
  URL del video de movimiento de referencia; admite .mp4, .mov.
  El tamaño del archivo de video no debe superar los 10 MB; tanto el ancho como la altura deben ser >= 300px; duración de 3 a 30 segundos.
</ParamField>

<ParamField body="prompt" type="string">
  Prompt positivo para describir la escena, el estilo, la iluminación, etc.; la longitud no debe superar los 2500 caracteres.

  Límite de longitud: 0 - 2500
</ParamField>

<ParamField body="model_name" type="string" required={true} default="kling-v3-0-std">
  Nombre del modelo. kling-v3-0-std: modo estándar, alta relación costo-rendimiento; kling-v3-0-pro: modo profesional, mejor calidad de video.

  Valores opcionales: `kling-v3-0-std`, `kling-v3-0-pro`
</ParamField>

<ParamField body="negative_prompt" type="string">
  Prompt negativo, que describe los elementos que deben evitarse en el video generado; la longitud no debe superar los 2500 caracteres.

  Límite de longitud: 0 - 2500
</ParamField>

<ParamField body="keep_original_sound" type="boolean" default={true}>
  Indica si se conserva el audio original del video de referencia.
</ParamField>

<ParamField body="character_orientation" type="string" required={true}>
  Modo de fotograma de salida:

  * image: se priorizan la postura del personaje y la composición de la imagen de referencia, y se transfiere la acción al personaje de la imagen (salida de 5 segundos)
  * video: se priorizan la postura del personaje y la composición del video de referencia, y se aplica la acción del video al personaje de la imagen (la duración de salida coincide con la del video de referencia, con un máximo de 30 segundos)

  Valores opcionales: `image`, `video`
</ParamField>

## Información de respuesta

<ResponseField name="task_id" type="string" required={true}>
  Use task\_id para solicitar la [API de consulta de resultados de tareas](/es/docs/models/reference-get-async-task-result) y recuperar la salida generada.
</ResponseField>
