# Con quale frequenza dovresti interrogare un’API asincrona di generazione video? > Esegui polling rapido solo quando lo stato può cambiare, poi applica backoff con jitter e un limite massimo. Combina webhook, segnali del provider e condizioni di arresto. Un loop di polling deve seguire il tempo di completamento, il costo delle richieste e l’incertezza, non un `sleep` fisso. Cinque secondi possono andare bene per un’anteprima ma sprecare chiamate su un rendering lungo. ## Parti dalla durata prevista del job | Durata prevista | Intervallo iniziale | Intervallo successivo | Uso | |---|---:|---:|---| | Meno di 30 secondi | 2-4 s | 5-8 s | Anteprima | | 30-120 secondi | 4-8 s | 10-20 s | Generazione standard | | 2-10 minuti | 10-20 s | 30-60 s | Rendering lungo | | Sconosciuta | 5 s | Backoff fino a 60 s | Modello nuovo | Salva i percentili osservati per modello e configurazione. La tabella è un punto di partenza, non uno SLA. ## Usa backoff adattivo invece di un timer fisso ```text delay = min(max_delay, base_delay * 2^unchanged_rounds) scheduled_delay = delay * random(0.8, 1.2) ``` Azzera il contatore quando c’è progresso e mantieni il limite sotto la latenza di notifica accettabile. ## Tratta i segnali del provider come autorevoli | Segnale | Azione sicura | |---|---| | `Retry-After` | Attendi almeno il tempo indicato | | Rate limit | Backoff globale della route | | In coda | Polling lento | | In elaborazione | Segui il tempo residuo | | Successo o errore | Ferma il polling normale | | Job sconosciuto | Riconcilia prima di reinviare | ## Combina webhook e polling di riconciliazione Verifica le firme, deduplica gli eventi e rispondi rapidamente. Interroga lentamente solo i job senza webhook. ## Limita la concorrenza dell’intero account Applica un budget globale o per provider e separa capacità di stato e capacità di invio. ## Ferma i job abbandonati e terminali Ferma su successo, errore, annullamento o scadenza e conserva motivo e ID remoto. ## Misura l’efficienza del polling Traccia poll per completamento, ritardo di rilevamento, rate limit, età irrisolta, copertura webhook e backlog. [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-often-poll-asynchronous-video-generation-api) può unificare l’accesso a modelli di testo, immagini e video. Mantieni regole di stato specifiche per route. ## In conclusione Parti dalle indicazioni del provider e combina backoff, jitter, limiti e regole di arresto. Usa webhook per notificare e polling lento per riconciliare. ## FAQ ### Qual è un intervallo iniziale ragionevole? Segui la documentazione; in assenza di indicazioni, 3-5 secondi sono un inizio prudente per job brevi. ### Tutti i job devono usare lo stesso intervallo? No. Considera durata prevista, età, stato e istruzioni del provider. ### Un errore HTTP deve fermare il polling? Riprova gli errori transitori con backoff e fermati su errori chiari di autenticazione, validazione o stato terminale. ### I webhook sono sufficienti? Possono arrivare tardi o duplicati, quindi mantieni un polling lento di riconciliazione. ### Come evito una raffica simultanea? Aggiungi jitter, limita la concorrenza e pianifica ogni job separatamente. ### Atlas Cloud semplifica il polling multimodello? Può unificare l’accesso, ma l’applicazione normalizza stati e tempi per modello.