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ñadircallback_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: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 undata.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
La forma de la respuesta es diferente de las rutas de video de OpenAI
La forma de la respuesta es diferente de las rutas de video de OpenAI
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.La tarea nunca llega a succeed
La tarea nunca llega a succeed
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.¿Debo usar callback_url o consulta periódica?
¿Debo usar callback_url o consulta periódica?
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
- Lee la referencia de la API de texto a video de Kling.
- Consulta periódicamente con Obtener una tarea de Kling.
- Configura callbacks con Usar URLs de callback de Kling.
- Encuentra modelos de video de Kling en Models.
- Revisa Usar consulta periódica y webhooks para la generación de video.
- Estima el costo de la tarea con Estimar el costo de una solicitud antes de llamar a un modelo.