> ## Documentation Index
> Fetch the complete documentation index at: https://docs.identifai.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Resultados diferidos

> Algunos resultados de un envío, como las explicaciones textuales de los mapas XAI y de la heatmap, se producen después de los resultados principales. Descubre cómo seguirlos y cómo recibir una notificación cuando estén completos.

# Resultados diferidos

El análisis de un envío tiene dos fases:

1. el **análisis principal** produce el veredicto y los resultados de clasificación. Cuando termina, el `status` del envío pasa a `done` (o `errored`) y los resultados principales se envían a `webhook_url` y a tus webhooks, como siempre;
2. 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_xai` y `with_llm_xai` (consulta [XAI – eXplainable AI](https://docs.identifai.net/es/classification/classify-image.md#xai-explainable-ai)) y devueltas en la `description` de las `explanations` de los resultados por modelo.

Los resultados diferidos nunca cambian el veredicto, los resultados de clasificación ni el `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:

| Campo | Descripción |
| - | - |
| `deferred_status` | `pending` (análisis principal aún en curso), `inprogress`, `done`, `errored` (al menos un paso diferido ha fallado: los resultados principales siguen siendo válidos), `skipped` (el análisis principal ha fallado), `expired` (no completado a tiempo) |
| `deferred_progress` | `{ "current_idx": 1, "total": 2 }`: pasos diferidos completados hasta ahora, sobre el total |
| `deferred_errors` | Mensajes públicos de los pasos diferidos que han fallado |

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.

> [!NOTE]
>
> `expired` no es definitivo: si los resultados diferidos se completan después del plazo, `deferred_status` pasa a `done` o `errored`.

> [!NOTE]
>
> `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, establece `deferred_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.

```json theme={null}
{
  "event": "submission.deferred.completed",
  "version": 1,
  "sent_at": "2026-10-27T12:00:00.000Z",
  "submission": {
    "identifier": "8f0c2d3e9b1a4c7d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5",
    "type": "image",
    "status": "done",
    "deferred_status": "done",
    "deferred_progress": { "current_idx": 1, "total": 1 },
    "completed_at": "2026-10-27T11:58:41.000Z",
    "deferred_completed_at": "2026-10-27T11:59:58.000Z",
    "deferred_errors": [],
    "xai": [
      {
        "model": "...",
        "method": "legrad",
        "type": "attention_map",
        "artifact": "...",
        "description": "The model focuses on the skin texture around the eyes and on the hairline, where the generated details are less consistent."
      }
    ],
    "heatmaps": [
      {
        "model": "...",
        "artifact": "...",
        "description": "The highlighted area around the mouth shows signs of manipulation."
      }
    ],
    "frames": []
  }
}
```

| Campo | Descripción |
| - | - |
| `event` | Siempre `submission.deferred.completed` |
| `version` | Versión del payload, incrementada en los cambios incompatibles |
| `sent_at` | Cuándo se envió la notificación |
| `submission.identifier` | El mismo `identifier` devuelto en el envío y enviado en la notificación principal |
| `submission.type` | `image`, `audio` o `video` |
| `submission.status` | Estado del análisis principal |
| `submission.deferred_status` | `done`, `errored` o `expired` |
| `submission.deferred_errors` | Mensajes públicos de los pasos diferidos que han fallado |
| `submission.xai` | Explicaciones textuales de los mapas XAI |
| `submission.heatmaps` | Explicaciones textuales de las heatmaps |
| `submission.frames` | Solo vídeos: `hash`, `name`, `status`, `deferred_status`, `xai` y `heatmaps` de cada frame |

> [!WARNING]
>
> La entrega es **al menos una vez** (*at least once*): la misma notificación puede llegar más de una vez, así que elimina los duplicados por `identifier` y `deferred_status`. Una notificación `expired` puede ir seguida de una segunda notificación con el resultado real (`done` o `errored`): la más reciente sustituye a la anterior.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.