<!-- Canonical URL: https://ask.atlascloud.ai/fr/how-often-poll-asynchronous-video-generation-api -->

# À quelle fréquence faut-il interroger une API asynchrone de génération vidéo ?

> Interrogez rapidement pendant la courte période où l’état peut changer, puis appliquez un backoff avec jitter et un plafond. Combinez webhooks, limites du fournisseur et conditions d’arrêt.

<!-- Canonical URL: https://ask.atlascloud.ai/how-often-poll-asynchronous-video-generation-api -->

Une boucle de polling doit suivre le délai d’achèvement, le coût des requêtes et l’incertitude, pas un `sleep` fixe. Cinq secondes peuvent convenir à un aperçu mais gaspiller des appels pour un rendu de plusieurs minutes.

## Partir de la durée prévue du job

| Durée prévue | Intervalle initial | Intervalle ultérieur | Usage |
|---|---:|---:|---|
| Moins de 30 secondes | 2 à 4 s | 5 à 8 s | Aperçu |
| 30 à 120 secondes | 4 à 8 s | 10 à 20 s | Génération standard |
| 2 à 10 minutes | 10 à 20 s | 30 à 60 s | Rendu long |
| Inconnue | 5 s | Backoff plafonné à 60 s | Nouveau modèle |

Enregistrez les percentiles réels par modèle et configuration. Ce tableau est un point de départ, pas un SLA.

## Utiliser un backoff adaptatif plutôt qu’un délai fixe

```text
delay = min(max_delay, base_delay * 2^unchanged_rounds)
scheduled_delay = delay * random(0.8, 1.2)
```

Réinitialisez le compteur lors d’un progrès et maintenez le plafond sous la latence de notification acceptable.

## Traiter les signaux du fournisseur comme prioritaires

| Signal | Action sûre |
|---|---|
| `Retry-After` | Attendre au moins la durée indiquée |
| Limite de débit | Backoff global de la route |
| En file | Polling lent |
| En traitement | Se rapprocher du temps restant |
| Réussi ou échoué | Arrêter le polling normal |
| Job inconnu | Réconcilier avant de renvoyer |

## Combiner webhooks et polling de réconciliation

Vérifiez les signatures, dédupliquez les événements et répondez vite. Interrogez lentement uniquement les jobs dont le webhook manque.

## Borner la concurrence du compte

Appliquez un budget global ou par fournisseur et séparez la capacité de statut de celle des nouvelles soumissions.

## Arrêter les jobs abandonnés et terminaux

Arrêtez en cas de réussite, échec, annulation ou échéance. Conservez la raison et l’identifiant distant.

## Mesurer l’efficacité du polling

Suivez les polls par job terminé, le retard de détection, les limites de débit, l’âge non résolu, la couverture webhook et le backlog.

[Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-often-poll-asynchronous-video-generation-api) peut unifier l’accès aux modèles de texte, d’image et de vidéo. Gardez des règles d’état propres à chaque route.

## En résumé

Partez des recommandations du fournisseur, puis combinez backoff, jitter, limites de concurrence et règles d’arrêt. Utilisez les webhooks pour notifier et un polling lent pour réconcilier.

## FAQ

### Quel intervalle initial choisir ?

Suivez la documentation ; à défaut, 3 à 5 secondes constituent un départ prudent pour un job court.

### Tous les jobs utilisent-ils le même intervalle ?

Non. Tenez compte de la durée prévue, de l’âge, de l’état et des recommandations du fournisseur.

### Faut-il arrêter après une erreur HTTP ?

Réessayez les erreurs transitoires avec backoff, mais arrêtez-vous sur une erreur claire d’authentification, de validation ou un état terminal.

### Les webhooks suffisent-ils ?

Ils peuvent être retardés ou dupliqués ; conservez un polling lent de réconciliation.

### Comment éviter un pic simultané de polls ?

Ajoutez du jitter, limitez la concurrence et planifiez chaque job indépendamment.

### Atlas Cloud simplifie-t-il le polling multimodèle ?

Il peut unifier l’accès, mais l’application doit normaliser états et temporisations par modèle.
