Proceso de solicitud
Para utilizar la API de generación de movimiento Kling, primero dirígete a la consola de Ace Data Cloud para obtener tu token de API, que debes guardar como respaldo.
Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invitará a registrarte e iniciar sesión; una vez completado, regresarás automáticamente a la página actual.
Un token de API es suficiente para acceder a todos los servicios de la plataforma, no es necesario solicitar uno por cada servicio. La primera solicitud incluirá un crédito gratuito para que puedas probarlo; si el crédito es insuficiente, puedes recargar el saldo general en la consola.
📘 Documentación completa: API de generación de movimiento Kling →
Uso básico
Primero, debes entender la forma básica de uso, que consiste en ingresar la palabra claveprompt, la URL de la imagen de referencia image_url y el enlace del video de referencia video_url, para obtener el resultado procesado. Luego, también necesitamos ingresar el modelo mode, que actualmente incluye los modelos std y pro, con los siguientes detalles:
accept: el formato de respuesta que deseas recibir, aquí se establece comoapplication/json, es decir, en formato JSON.authorization: la clave para llamar a la API, que puedes seleccionar directamente después de solicitarla.
image_url: URL de la imagen de referencia del aspecto del personaje. Soporta JPG/JPEG/PNG, archivo ≤50MB, ancho y alto ≥300px, relación de aspecto de 1:2.5 a 2.5:1; el personaje debe mostrarse claramente en la parte superior del cuerpo o en su totalidad, incluyendo la cabeza.video_url: URL del video de referencia de la acción. Soporta MP4/MOV, archivo ≤100MB, ancho y alto entre 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 usar un video de un solo plano continuo donde el personaje esté siempre dentro del encuadre.mode: el modo de generación del video, que incluye el modo estándarstdy el modo rápidopro.keep_original_sound: opción para elegir si se debe conservar el sonido original del video, valores enumerados: yes, no.character_orientation: la orientación del personaje en el video generado, que puede coincidir con la imagen o con el video, valores enumerados: image, video.prompt: palabra clave.callback_url: URL donde se necesita el resultado de la llamada.async: opcional, si se establece entrue, la interfaz devuelve inmediatamentetask_id, sin necesidad de proporcionarcallback_url, y luego se puede consultar el resultado a través de la interfaz de consulta de tareas correspondiente.
success, el estado de la tarea de generación del video en ese momento.task_id, el ID de la tarea de generación del video en ese momento.video_id, el ID del video de la tarea de generación en ese momento.video_url, el enlace del video de la tarea de generación en ese momento.duration, la duración del video de la tarea de generación en ese momento.state, el estado de la tarea de generación del video en ese momento.
data para obtener el video de Kling.
Además, si deseas generar el código de integración correspondiente, puedes copiarlo directamente, por ejemplo, el código de CURL es el siguiente:
Callback asíncrono
Debido a que el tiempo de generación de la API de generación de movimiento Kling es relativamente largo, aproximadamente de 1 a 2 minutos, si la API no responde durante mucho tiempo, la solicitud HTTP mantendrá la conexión, lo que provocará un consumo adicional de recursos del sistema. Por lo tanto, esta API también ofrece soporte para callbacks asíncronos. El flujo general es: cuando el cliente inicia la solicitud, se especifica un campo adicionalcallback_url. Después de que el cliente envía la solicitud a la API, la API devolverá inmediatamente un resultado que incluye un campo task_id, que representa el ID de la tarea actual. Cuando la tarea se complete, el resultado del video generado se enviará al callback_url especificado por el cliente en formato JSON POST, que también incluirá el campo task_id, de modo que el resultado de la tarea se pueda asociar mediante el ID.
A continuación, utilizaremos un ejemplo para entender cómo operar específicamente.
Primero, el callback de Webhook es un servicio que puede recibir solicitudes HTTP; el desarrollador debe reemplazarlo con la URL de su propio servidor HTTP. Para facilitar la demostración, utilizaremos un sitio de ejemplo de Webhook público https://webhook.site/, donde al abrir el sitio obtendrás una URL de Webhook, como se muestra en la imagen:
Copia esta URL y podrás usarla como Webhook; el ejemplo aquí es https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3.
A continuación, podemos establecer el campo callback_url con la URL de Webhook mencionada anteriormente, al mismo tiempo que ingresamos los parámetros correspondientes, como 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, los otros campos son similares a los anteriores, a través de este campo se puede realizar la asociación de tareas.
Manejo de errores
Al llamar a la API, si se encuentra con un error, la API devolverá el código de error correspondiente y la información. Por ejemplo:400 token_mismatched: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.400 api_not_implemented: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.401 invalid_token: No autorizado, token de autorización invá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.