Configuración del entorno

Para utilizar la API, realice los siguientes pasos previos: 1. Registrar cuenta y acceder a Ace Data Cloud. 2. Solicitar el servicio de API de generación de vídeos Kling.

Pasos detallados

Solicitud del servicio

Navegue a la página de la API de generación de vídeos Kling y seleccione el botón "Obtener". Si no tiene sesión iniciada, se redirigirá automáticamente a la pantalla de autenticación. Tras el inicio de sesión, regresará a la página de soliictud. La primera solicitud es gratuita. Uso básico

Los parámetros requeridos son: - descripcion: contenido textual para generación del vídeo.

• tipo_accion: operación a ejecutar, con opciones text2video (texto a vídeo), image2video (imagen a vídeo) y extend (extensión de vídeo).
• url_imagen_inicial: dirección de la imagen de referencia inicial.
• modelo: versión específica para renderizado.

Modelos disponibles: kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo y kling-video-o1. Configure los encabezados: - accept: formato de respuesta application/json.

• authorization: clave de autenticación.

Ejemplo de cuerpo de solicitud: ``` { "modelo": "kling-v2-5-turbo", "modo": "std", "tipo_accion": "text2video", "url_imagen_inicial": "https://example.com/imagen-inicial.jpg", "relacion_aspecto": "9:16", "descripcion": "Un perro jugando en un parque al atardecer", "url_callback": "https://ejemplo-webhook.com" }

Respuesta esperada: ```
{
  "exito": true,
  "id_video": "c7d8e9f0-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
  "url_video": "https://cdn.klingai.com/bs2/upload-kling-api/1234567890/text2video/Video0987654321_raw.mp4",
  "duracion": "7.5",
  "estado": "completado",
  "id_tarea": "f0e1d2c3-b4a5-6789-0123-4567890abcde"
}

Extensión de contenido

Para ampliar un vídeo existente, configure tipo_accion como extend e incluya el id_video obtenido en la generación inicial. ``` { "tipo_accion": "extend", "id_video": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "descripcion": "Escena de animales en movimiento en un bosque", "duracion": 12 }

Callback asíncrono
------------------

Por la duración de procesamiento (1-2 minutos), configure `url_callback` en la solicitud. Los resultados se enviarán mediante POST JSON a la URL especificada tras finalizar la tarea. Ejemplo de respuesta inicial: ```
{
  "id_tarea": "d5e6f7a8-b9c0-1234-5678-90abcdef123456"
}

Manejo de errores

En caso de fallo, la API devuelve: ``` { "exito": false, "error": { "codigo": "invalid_parameters", "mensaje": "Parámetros inválidos en 'relacion_aspecto'" }, "id_rastreo": "a1b2c3d4-e5f6-7890-1234-567890abcdef" }