Flux des tâches vidéo
La génération vidéo PopGo est asynchrone : soumettez une tâche, conservez son ID, interrogez son état puis téléchargez le résultat.
Endpoints et champs
POST https://api.popgo.site/v1/videos
GET https://api.popgo.site/v1/videos/{task_id}
GET https://api.popgo.site/v1/videos/{task_id}/content
Authorization: Bearer YOUR_API_KEY
| Champ | Description |
|---|---|
model | ID public obligatoire |
prompt | Instruction obligatoire de scène et de mouvement |
duration / seconds | Valeurs autorisées par le modèle |
resolution | Résolution autorisée par le modèle |
aspect_ratio | Proportion autorisée par le modèle |
| Références | Champs image, vidéo ou audio de la page du modèle |
curl -X POST https://api.popgo.site/v1/videos \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL","prompt":"A bamboo forest in morning mist, slow camera movement","seconds":5,"resolution":"480p","aspect_ratio":"16:9"}'
Interrogation et progression
Les états courants sont queued, in_progress, completed et failed. Affichez progress lorsqu’il est présent ; ne fabriquez pas de pourcentage absent. À completed, lisez l’URL ou appelez /content.
curl https://api.popgo.site/v1/videos/YOUR_TASK_ID -H "Authorization: Bearer YOUR_API_KEY"
Un code HTTP 400 concerne le modèle, le type, la durée, la résolution, la proportion ou une référence. 401/403 concerne l’authentification. La facturation dépend du modèle, pas du nombre de sondages.
Interrogation, délais et reprises
Créez une seule fois et gardez id,modèle,durée,résolution,mode. Un délai dépassé peut suivre une acceptation : consultez les tâches avant de recréer. Reprendre consultation ou téléchargement du même id ne crée pas une autre vidéo.
Intervalles3–5s ; C10–15s ; Kling environ10s avec au moins15 minutes d'attente. Pour429/502/503 ou réseau temporaire, utilisez un recul borné et Retry-After. Corrigez400, puis authentification/permissions pour401/403. À l'échéance client, indiquez l'attente dépassée et gardez l'ID, sans inventer un échec du service.
progress peut rester0 puis passer à100, ou manquer. model,usage,résolution,durée réelle,fps peuvent manquer. Gardez les paramètres et examinez le fichier ; absence de usage ne signifie pas gratuit. queued/in_progress ne sont pas des échecs.
Les URL peuvent expirer ou demander une authentification ; préférez /content PopGo. Après completed, reprenez temporairement le téléchargement, pas la création. Accordez du temps aux gros fichiers et vérifiez une vidéo plutôt qu'une erreur JSON. Aucun API Key PopGo vers un hôte externe.
Cinq étapes de diagnostic
| Étape | Ce qu'elle démontre | Ce qu'elle ne démontre pas |
|---|---|---|
| Validation interface | Acceptation locale des modes,nombres,sources | Aucune requête ne signifie pas refus du service |
| Analyse et capacités PopGo | 400/500 avant ou après création | Absence de logs ne prouve pas une panne du fournisseur |
| Requête sortante | Champs et rôles image/vidéo/audio | Champs corrects ne garantissent pas l'accès |
| Acceptation et interrogation | ID,état,étape de l'erreur | 200 ou ID ne prouve pas l'usage des références ou la gratuité |
| Média final | Effet sur cadres,sujet,action,son | Une URL ne prouve pas la qualité |
Notez modèle,heure,ID fictif,mode,nombres/sources et erreur courte, sans clés,cookies,URL signées ni médias privés. Séparez capacité et modération, vérifiez la facturation même après échec et corrigez la cause avant un nouveau coût.