Skip to main content

Lo que vas a crear

Enviarás una tarea de texto a video de Kling, almacenarás el ID de tarea devuelto, consultarás el endpoint de tarea de Kling correspondiente y decidirás cuándo añadir callback_url para notificaciones push.

Requisitos previos

  • Una clave de API de CometAPI almacenada en COMETAPI_KEY
  • Python 3.10+ con requests, o Node.js 18+
  • Un worker del lado del servidor para consultar el estado o un endpoint de callback HTTPS para webhooks

Clave de API, URL base, autenticación

Crea una tarea de texto a video de Kling con:
Consulta la tarea con:
Autentícate con un token Bearer:

Ejemplos de código

Usa las pestañas de abajo para ver ejemplos que puedes copiar en cURL, Python y Node.js.

Explicación del flujo

La generación de video de Kling es asíncrona. El endpoint de creación devuelve un data.task_id. Consulta GET /kling/v1/videos/text2video/<task_id> hasta que data.task_status alcance succeed o failed. Cuando la tarea se complete correctamente, copia la URL del recurso finalizado desde data.task_result a tu propio almacenamiento si necesitas acceso duradero. Agrega callback_url cuando quieras que las actualizaciones del estado de la tarea se envíen a un endpoint HTTPS que controles. Mantén disponible la consulta periódica para la conciliación y para los casos en que falle la entrega del callback.

Parámetros comunes

Solución de problemas / Preguntas frecuentes

Kling usa campos JSON específicos del proveedor como data.task_id, data.task_status y data.task_result. No lo analices como las rutas compatibles con OpenAI /v1/videos.
Usa una consulta periódica con límites e inspecciona data.task_status_msg cuando una tarea falle. Guarda el ID de la tarea para diagnósticos posteriores.
Usa la consulta periódica como base. Agrega callback_url para la entrega por envío automático y luego concilia el estado final con la consulta periódica.

Próximos pasos