<!-- Canonical URL: https://ask.atlascloud.ai/es/trace-ai-video-request-submission-polling-download -->

# ¿Cómo seguir una solicitud de video con IA desde el envío hasta el polling y la descarga?

> Crea un operation ID estable antes del envío, propágalo por eventos internos y relaciónalo con requests, jobs, polls, webhooks y activos almacenados.

<!-- Canonical URL: https://ask.atlascloud.ai/trace-ai-video-request-submission-polling-download -->

Una solicitud asíncrona cruza API, cola, modelo, worker, webhook y almacenamiento. Crea una clave durable antes de la primera llamada remota para poder explicar todo el recorrido.

## Crea el operation ID en el límite

```json
{"operation_id":"vidop_01J...","tenant_id":"acct_42","request_fingerprint":"sha256:..."}
```

Debe ser opaco, único y no contener correo, prompt ni credenciales.

## Separa operaciones, intentos y spans

| Registro | Cardinalidad | Propósito |
|---|---:|---|
| Operación | Una | Correlación estable |
| Intento | Uno o más | Explicar retries |
| Mapeo de job | Cero o más | Unir estado y webhook |
| Span | Muchos | Medir etapas |
| Activo | Cero o más | Probar salida durable |

## Propaga contexto por la cola

Incluye `operation_id`, `attempt_id` y trace context en cada mensaje. Un retry conserva IDs lógicos y crea un nuevo registro de entrega.

## Registra evidencia del envío

Antes guarda fingerprint, ruta, parámetros e idempotency key. Después guarda HTTP, request ID, job ID, estado y uso. Un timeout es `submission_unknown`, no rechazo confirmado.

## Traza polling sin ruido

| Campo | Motivo |
|---|---|
| Job ID | Correlación remota |
| Estado raw y normalizado | Auditoría |
| HTTP | Diagnóstico |
| Latencia | Medición |
| Próximo poll | Explicar scheduler |

## Une webhooks de forma segura

Valida, deduplica y busca el mapeo durable. Conserva eventos unmatched si la respuesta de envío aún no llegó.

## Traza descarga y almacenamiento

Registra bytes, tipo, checksum, validación, object key y tiempos. No guardes signed URLs ni headers completos.

## Construye una cronología de soporte

```text
08:00:00 accepted
08:00:03 provider job accepted
08:00:42 webhook succeeded
08:00:50 asset stored
```

[Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=trace-ai-video-request-submission-polling-download) puede unificar modelos, pero cada intento debe conservar modelo y ruta exactos.

## En resumen

Usa un operation ID estable, IDs secundarios por intento, mapeos durables y credenciales redactadas hasta que el activo quede verificado y almacenado.

## FAQ

### ¿Qué ID debe ser la raíz?

Un operation ID de la aplicación creado antes de llamar al proveedor.

### ¿Los reintentos comparten trace?

Comparten operation ID, pero cada intento tiene attempt ID y spans propios.

### ¿Qué registrar en un poll?

Hora, job ID, estado, HTTP, metadata, siguiente consulta y contexto.

### ¿Cómo se une un webhook?

Busca el job o event ID en una tabla de correlación durable.

### ¿Guardar la URL firmada?

No; registra solo datos redactados necesarios.

### ¿Cómo encaja Atlas Cloud?

Unifica acceso, mientras la aplicación conserva IDs, rutas, uso y almacenamiento.
