model: kling-v3-motion. Proporcione referencias de apariencia y movimiento, envíe una solicitud asíncrona y realice el seguimiento del img_uuid devuelto mediante sondeo o callback.API de Kling V3 Motion Control para video de personajes guiado por referencia
Acceda a Kling V3 Motion Control a través de GoEnhance con
Obtener clave API
Combine referencias de apariencia y movimiento en una sola solicitud
Defina la apariencia del personaje
Utilice image_url para una imagen clara del personaje de cuerpo completo o medio cuerpo, o utilice como máximo un elemento de Kling a través de element_ids. La entrada de elemento fuerza character_orientation: video.
Transferir movimiento desde un video de referencia
Proporcione un archivo MP4 o MOV obligatorio en video_url. La salida sigue el movimiento continuo utilizable de ese archivo; este endpoint no tiene un parámetro duration.
Valide los medios antes del envío; los valores de duración o resolución no admitidos deben ser rechazados en el lado del cliente.
Capacidades y reglas de validación de la API de Kling V3 Motion Control
Endpoint y modelo
Realice un POST a <code>https://api.goenhance.ai/api/v1/videos/generations</code> con <code>model: kling-v3-motion</code>.
Prompt
Envíe un <code>prompt</code> obligatorio de hasta 2,500 caracteres para describir el personaje, la vestimenta, la escena o la dirección de generación relevante.
Entrada de apariencia
Una <code>image_url</code> puede ser JPG, JPEG o PNG, de hasta 50 MB, al menos 300 px por lado, con una relación de aspecto de 1:2.5 a 2.5:1.
Entrada de movimiento
El <code>video_url</code> obligatorio debe ser MP4 o MOV, no mayor a 100 MB, con dimensiones de 340 a 3,850 px.
Orientación y duración
<code>character_orientation: video</code> acepta de 3 a 30 segundos; <code>image</code> acepta de 3 a 10 segundos. El valor predeterminado documentado es <code>video</code>.
Resolución y audio
Elija 720p o 1080p; no hay nivel 4K. <code>generate_audio</code> mantiene el sonido original del video de movimiento y está desactivado por defecto.
El precio es por segundo generado, mientras que GoEnhance mide la longitud del video de movimiento de entrada como el cargo límite superior de la solicitud.
Precios de la API de Kling V3 Motion Control
Tarifa de 720p
6.3 tokens por segundo generado, equivalente a $0.126/s al precio documentado de $0.02 por token.
Tarifa de 1080p
8.4 tokens por segundo generado, equivalente a $0.168/s al precio documentado de $0.02 por token.
Estimación de costos
Estime el costo máximo de la solicitud como la duración medida del video de movimiento multiplicada por la tarifa exacta para la resolución seleccionada.
Facturación basada en entrada medida
GoEnhance transfiere y mide <code>video_url</code> antes de deducir tokens, por lo que cambiar el archivo remoto después de la medición no altera la entrada facturada.
La salida puede ser más corta
Kling extrae movimiento continuo utilizable, por lo que un movimiento difícil o muy rápido puede producir una salida más corta que el video de referencia.
Sin parámetro de duración
No envíe <code>duration</code>; el endpoint lo rechaza y la longitud de salida sigue el movimiento utilizable extraído del video de referencia.
Integre Kling V3 Motion Control en seis pasos
1
1. Cree una clave de API
Cree una clave de API de GoEnhance y envíela en el encabezado
Authorization. 2
2. Valide ambas referencias
Compruebe la claridad y las dimensiones de la imagen, luego verifique el formato, el tamaño, las dimensiones y la longitud dependiente de la orientación del video de movimiento.
3
3. Envíe y persista la tarea
Realice un POST de la solicitud con
model: kling-v3-motion, luego guarde el img_uuid devuelto antes de entregar el trabajo a un procesador en segundo plano. 4
4. Rastree el estado
Realice un sondeo a
GET /api/v1/jobs/detail o proporcione una custom_callback_url HTTPS accesible públicamente. 5
5. Maneje las devoluciones de llamada de forma idempotente
Trate los eventos de estado repetidos de forma segura. Una devolución de llamada que no devuelva HTTP 200 puede reintentarse hasta tres veces con un tiempo de espera de tres segundos por intento.
6
6. Almacene el resultado final
Separe el procesamiento, el éxito y el manejo de errores, y guarde la URL del video final solo después de que la tarea alcance un estado terminal.
Utilice medios que esté autorizado a procesar y diseñe para una finalización asíncrona.
Casos de uso para desarrolladores de Kling V3 Motion Control
Clips de interpretación de personajes
Aplique referencias de movimiento aprobadas a una apariencia de personaje consistente para canales de video promocionales o narrativos cortos.
Vistas previas de danza y coreografía
Transfiera movimiento de ensayo con licencia a vistas previas dirigidas por personajes mientras preserva el consentimiento y los derechos de audio de origen.
Conceptos de animación de personajes de juegos
Genere estudios de movimiento a partir de arte de personajes y movimiento grabado antes de comprometerse con un flujo de trabajo de animación completo.
Variantes de campaña localizadas
Parametrice prompts y entradas de apariencia para variantes creativas regionales mientras reutiliza una capa de orquestación de trabajo.
Flujos de trabajo de artistas virtuales
Construya canales de artistas controlados en torno a referencias de imagen, activos de movimiento y configuraciones de orientación aprobados.
Previsualización
Pruebe si una referencia de movimiento es adecuada para un personaje antes de la edición, composición y revisión posteriores.
Respuestas a preguntas comunes sobre integración, precios, validación y la API de Kuaishou.