Proceso de solicitud
Para utilizar Kling Motion Generation API, primero obtenga su API Token en la consola de Ace Data Cloud y guárdelo para usarlo posteriormente.
Si aún no ha iniciado sesión ni se ha registrado, será redirigido automáticamente a la página de inicio de sesión para invitarle a registrarse e iniciar sesión; tras completarlo, volverá automáticamente a la página actual.
Un API Token permite llamar a todos los servicios de la plataforma, sin necesidad de solicitar uno por separado para cada servicio. La primera solicitud incluye créditos gratuitos para una experiencia sin coste; cuando los créditos sean insuficientes, puede recargar saldo general en la consola.
📘 Documentación completa: Kling Motion Generation API →
Uso básico
Primero, comprendamos el método básico de uso: basta con introducir el texto de indicaciónprompt, la imagen de referencia image_url y el enlace de video de referencia video_url para obtener el resultado procesado; después también necesitamos introducir el modelo mode, actualmente existen principalmente los modelos std, pro, y el contenido específico es el siguiente:
accept: el formato de resultado de respuesta que desea recibir; aquí se completa comoapplication/json, es decir, formato JSON.authorization: la clave para llamar a la API, que puede seleccionarse directamente desde el menú desplegable después de solicitarla.
image_url: URL de la imagen de referencia de la apariencia del personaje. Admite JPG/JPEG/PNG, archivo ≤50MB, ancho y alto ≥300px, relación de aspecto de 1:2.5～2.5:1; el personaje debe mostrar claramente la parte superior del cuerpo o el cuerpo completo y la cabeza.video_url: URL del video de referencia de movimiento. Admite MP4/MOV, archivo ≤100MB, ancho y alto de 340–3850px, al menos 3 segundos; cuandocharacter_orientation=image, el máximo es de 10 segundos, y cuandocharacter_orientation=video, el máximo es de 30 segundos. Se recomienda utilizar un video continuo de una sola toma donde el personaje permanezca siempre dentro del encuadre.mode: el modo para generar videos, principalmente el modo estándarstdy el modo rápidopro.keep_original_sound: permite elegir si se conserva el sonido original del video; valores de enumeración: yes, no.character_orientation: la orientación del personaje en el video generado; se puede elegir que coincida con la imagen o con el video; valores de enumeración: image, video.prompt: texto de indicación.callback_url: URL que necesita recibir el resultado de la devolución de llamada.async: opcional; cuando se establece entrue, la interfaz devuelve inmediatamentetask_id, no es necesario proporcionarcallback_url, y posteriormente se obtiene el resultado mediante sondeo a través de la interfaz de consulta de tareas correspondiente.
success, el estado de la tarea de generación de video en este momento.task_id, el ID de la tarea de generación de video en este momento.video_id, el ID de video de la tarea de generación de video en este momento.video_url, el enlace de video de la tarea de generación de video en este momento.duration, la duración del enlace de video de la tarea de generación de video en este momento.state, el estado de la tarea de generación de video en este momento.
data del resultado.
Además, si desea generar el código de integración correspondiente, puede copiarlo directamente; por ejemplo, el código CURL es el siguiente:
Devolución de llamada asíncrona
Debido a que el tiempo de generación de Kling Motion Generation API es relativamente largo, aproximadamente 1-2 minutos, si la API no responde durante mucho tiempo, la solicitud HTTP mantendrá la conexión abierta, lo que provocará un consumo adicional de recursos del sistema, por lo que esta API también proporciona soporte para devoluciones de llamada asíncronas. El proceso general es: cuando el cliente inicia una solicitud, especifica adicionalmente un campocallback_url; después de que el cliente inicia la solicitud a la API, la API devuelve inmediatamente un resultado que contiene la información de un campo task_id, que representa el ID de la tarea actual. Cuando la tarea se completa, el resultado del video generado se enviará mediante POST JSON al callback_url especificado por el cliente, que también incluye el campo task_id, de modo que el resultado de la tarea puede asociarse mediante el ID.
A continuación, comprendamos mediante un ejemplo cómo operar específicamente.
Primero, una devolución de llamada Webhook es un servicio que puede recibir solicitudes HTTP; el desarrollador debe reemplazarlo por la URL de un servidor HTTP construido por sí mismo. Aquí, para facilitar la demostración, se utiliza un sitio web público de ejemplo de Webhook https://webhook.site/; al abrir este sitio web se puede obtener una URL de Webhook, como se muestra en la imagen:
Copie esta URL para usarla como Webhook; el ejemplo aquí es https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3.
A continuación, podemos establecer el campo callback_url como la URL de Webhook anterior y, al mismo tiempo, completar los parámetros correspondientes; el contenido específico se muestra en la imagen:
https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3, como se muestra en la imagen:
El contenido es el siguiente:
task_id en el resultado, los demás campos son similares a los anteriores, y la asociación de tareas se puede lograr mediante este campo.
Manejo de errores
Al llamar a la API, si se encuentra un error, la API devolverá el código de error y la información correspondientes. Por ejemplo:400 token_mismatched: Solicitud incorrecta, posiblemente debido a parámetros faltantes o no válidos.400 api_not_implemented: Solicitud incorrecta, posiblemente debido a parámetros faltantes o no válidos.401 invalid_token: No autorizado, token de autorización no válido o faltante.429 too_many_requests: Demasiadas solicitudes, ha superado el límite de tasa.500 api_error: Error interno del servidor, algo salió mal en el servidor.