Skip to main content
Usa polling como base para la generación de video porque cada trabajo asíncrono devuelve un ID de tarea que puedes consultar. Agrega webhooks solo cuando el endpoint de video seleccionado admita URLs de callback, y mantén polling como la fuente de verdad para entregas de callbacks perdidas o específicas del proveedor.

Crear una tarea de video

La siguiente solicitud crea una tarea de video mínima y almacena el ID devuelto. Agrega campos de duración, resolución o callback solo cuando la página del modelo seleccionado documente esos campos.
La respuesta incluye un ID de tarea y un estado:

Consultar el estado

La siguiente solicitud verifica el estado de la tarea de video:
La respuesta cambia a medida que avanza la tarea. Las respuestas completadas pueden incluir video_url cuando el adaptador del modelo tiene una URL de resultado; de lo contrario, usa campos de resultado específicos del modelo o la ruta de contenido /v1/videos/{id}/content cuando ese modelo admita descargas con proxy.

Recibir un webhook

CometAPI no define una carga útil de callback universal para cada modelo de video. Trata los callbacks como eventos pass-through específicos del proveedor, almacena el cuerpo sin procesar y reconcilia el estado final con polling. El siguiente controlador de Express acepta un callback de video y almacena el evento:
Una carga útil de callback suele incluir campos de identidad de la tarea y de estado, pero el anidamiento exacto depende del modelo o proveedor seleccionado:

Errores comunes

Enlaces relacionados

Última modificación el 23 de junio de 2026