Saltar al contenido principal
POST
/
v3
/
async
/
kling-v3.0-motion-control
Control de movimiento de 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>"
}
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.
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 y recuperar el resultado generado.

​
Encabezados de solicitud

​
Content-Type
string
requerido
Valores de enumeración: application/json
​
Authorization
string
requerido
Formato de autenticación Bearer: Bearer {{API Key}}.

​
Cuerpo de la solicitud

​
image
string
requerido
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.
​
video
string
requerido
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.
​
prompt
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
​
model_name
string
predeterminado:"kling-v3-0-std"
requerido
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
​
negative_prompt
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
​
keep_original_sound
boolean
predeterminado:true
Indica si se conserva el audio original del video de referencia.
​
character_orientation
string
requerido
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

​
Información de respuesta

​
task_id
string
requerido
Use task_id para solicitar la API de consulta de resultados de tareas y recuperar la salida generada.