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 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.
Obtener clave API
Producción cinematográfica con referencia de movimiento para la API de Kling V3 Motion Control

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.
Fotografía controlada con referencia de apariencia para la generación de videos de personajes

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.
Ensayo de coreografía de una sola escena utilizado como referencia de movimiento
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 https://api.goenhance.ai/api/v1/videos/generations con model: kling-v3-motion.

Prompt

Envíe un prompt 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 image_url 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 video_url obligatorio debe ser MP4 o MOV, no mayor a 100 MB, con dimensiones de 340 a 3,850 px.

Orientación y duración

character_orientation: video acepta de 3 a 30 segundos; image acepta de 3 a 10 segundos. El valor predeterminado documentado es video.

Resolución y audio

Elija 720p o 1080p; no hay nivel 4K. generate_audio 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 video_url 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 duration; 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.
Obtener clave de API
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.

Preguntas frecuentes sobre la API de control de movimiento Kling V3

¿Cuál es el endpoint de la API de Kling V3 Motion Control?

Envíe a través de GoEnhance en POST https://api.goenhance.ai/api/v1/videos/generations con model: kling-v3-motion. La respuesta devuelve un img_uuid.

¿Cómo funcionan los precios de la API de Kling V3 Motion Control?

720p cuesta 6,3 tokens/s ($0.126/s) y 1080p cuesta 8,4 tokens/s ($0.168/s). GoEnhance mide la duración del video de movimiento antes de la deducción como el cargo máximo de la solicitud.

¿Puedo enviar un parámetro de duración?

No. Este endpoint rechaza duration. El video de referencia debe cumplir con los límites específicos de orientación, y la salida sigue el movimiento continuo utilizable extraído de él.

¿Qué cambia character_orientation?

video sigue la dirección de orientación en el video de movimiento y permite de 3 a 30 segundos. image sigue la imagen de apariencia y permite de 3 a 10 segundos.

¿Puede la API generar audio nativo?

No. generate_audio solo conserva la banda sonora original del video de movimiento. Está desactivado por defecto; utilice audio solo cuando tenga los derechos necesarios.

¿Puedo usar un elemento Kling en lugar de una imagen?

La ruta V3 acepta como máximo un valor a través de element_ids (o el alias de valor único element_id). La entrada de elemento fuerza character_orientation: video.

¿Cómo funcionan las devoluciones de llamada (callbacks)?

Proporcione una custom_callback_url HTTPS pública. El cuerpo de la devolución de llamada coincide con la respuesta de detalle del trabajo; las entregas que no sean 200 pueden reintentarse hasta tres veces con un tiempo de espera de tres segundos.

¿Es esta la API oficial de Kuaishou?

No. Kling está asociado con Kuaishou, pero esta página describe el acceso independiente a través de GoEnhance. GoEnhance no se presenta como la API oficial, socio o desarrollador de modelos de Kuaishou o Kling.

Desarrolle con la API de control de movimiento Kling V3

API y precios de Kling V3 Motion Control | GoEnhance