Qu'est-ce que la génération asynchrone
Pour les requêtes de génération d'images longues, la plateforme prend en charge le mode asynchrone : après soumission, un ID de tâche est renvoyé immédiatement. Le client récupère le résultat final par polling, sans maintenir une connexion longue.
Le mode asynchrone convient aux scénarios avec des temps de génération longs et évite les interruptions par timeout. Il permet aussi de soumettre plusieurs tâches en lot.
Flux d'utilisation
Trois étapes : soumettre → consulter → télécharger.
1. Soumettre la tâche
Envoyez un POST à https://api.tvtapi.com/v1/images/async avec votre clé API (Bearer) et les paramètres :
curl -X POST https://api.tvtapi.com/v1/images/async \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"model":"model-name","prompt":"texte descriptif"}'
La réponse contient un task_id — votre identifiant pour la consultation et le téléchargement.
2. Consulter le statut
Consultez le statut avec task_id :
curl https://api.tvtapi.com/v1/images/async/{task_id} \
-H "Authorization: Bearer sk-xxxxxxxx"
États : queued (en file), in_progress (en cours), succeeded (réussi), failed (échec). Consultez toutes les quelques secondes jusqu'à l'état succeeded ou failed.
3. Télécharger l'image
Après réussite, téléchargez via :
curl -L https://api.tvtapi.com/v1/images/async/{task_id}/content \
-H "Authorization: Bearer sk-xxxxxxxx"
Ce endpoint renvoie une redirection 302 vers l'URL réelle de stockage. Chaque image a une limite de téléchargements ; la tâche expire après le délai.
Aussi sur le web
Si vous ne voulez pas coder, utilisez l'atelier d'images sur /fr-fr/user/image-studio. Il intègre un commutateur asynchrone qui, une fois activé, consulte automatiquement et affiche les résultats.
Notes
- La fonction asynchrone nécessite qu'un administrateur l'active et que le compte utilisateur ait la permission correspondante
- Les tâches ont une période de validité ; les tâches expirées ne peuvent être téléchargées
- Si une tâche reste en
in_progresstrop longtemps, le système la marque automatiquement commefailed