Resultados diferidos
El análisis de un envío tiene dos fases:- el análisis principal produce el veredicto y los resultados de clasificación. Cuando termina, el
statusdel envío pasa adone(oerrored) y los resultados principales se envían awebhook_urly a tus webhooks, como siempre; - los resultados diferidos se producen después, sin retrasar los resultados principales. Hoy son las explicaciones impulsadas por IA de los mapas XAI y de la heatmap, solicitadas con
with_xaiywith_llm_xai(consulta XAI – eXplainable AI) y devueltas en ladescriptionde lasexplanationsde los resultados por modelo.
status del envío.
Seguimiento de los resultados diferidos
Cuando un envío tiene resultados diferidos, el resultado de la clasificación (GET /api/classification/{identifier}, GET /api/classification_video/{identifier}, GET /api/classification_audio/{identifier}) también contiene:
En los vídeos, cada frame analizado en
results.images tiene su propio deferred_status. Los campos no están presentes en los envíos sin resultados diferidos.
expired no es definitivo: si los resultados diferidos se completan después del plazo, deferred_status pasa a done o errored.errored no significa que no haya ninguna explicación disponible. Cuando algunas explicaciones de los mapas XAI o de la heatmap no se pueden generar por un error técnico, deferred_status es errored y deferred_errors contiene Some explanations of the XAI maps could not be generated, mientras que las explicaciones generadas para los demás mapas se siguen devolviendo en explanations. Los mapas sin explicación permanecen en explanations con description en null; un mapa que el modelo no puede describir también tiene description null, y no es un error.Notificación de los resultados diferidos
Para recibir una notificación cuando los resultados diferidos estén completos, establecedeferred_webhook_url al enviar una imagen, un vídeo o un audio de voz (también desde URL). Funciona como webhook_url: requiere la misma habilitación y tiene las mismas restricciones de dominio y la misma autenticación. Si se omite o está vacío, no se envía ninguna notificación.
También puedes activar la notificación en los webhooks configurados en el dashboard, con Notificar los resultados diferidos y una URL dedicada opcional. La notificación solo se envía a los webhooks que recibieron el resultado principal del envío: por ejemplo, un webhook que solo notifica los resultados artificiales no recibe ninguna notificación diferida para un resultado humano.
La notificación se envía una sola vez, cuando los resultados diferidos pasan a done, errored o expired: no se envía para cada paso, ni cuando el análisis principal ha fallado (skipped). En un vídeo, se envía después del último frame.