Consulter une tâche image
GET /v1/tasks/{id}
Lit l’état d’une tâche d’image. Vous n’en avez besoin que si vous avez passé async: true — un appel synchrone par défaut renvoie déjà les images. Les tâches vidéo ne sont pas servies ici : utilisez GET /v1/video/generations/{task_id}.
Requête
bash
curl https://open.pikpikgo.com/v1/tasks/2608101909450810293847 \
-H "Authorization: Bearer $PIKPIK_API_KEY"Réponse
json
{
"id": "2608101909450810293847",
"object": "image.generation",
"created": 1786000185,
"model": "img-std-1",
"status": "succeeded",
"prompt": "une rue cyberpunk sous la pluie la nuit, reflets de néons",
"size": "16:9",
"quality": "2k",
"credits": 10,
"error": "",
"data": [
{ "url": "https://cdn.pikpikgo.com/ai/xxxx.png", "revised_prompt": "une rue cyberpunk sous la pluie la nuit, reflets de néons" }
]
}Cheminement des états
| status | Signification | Que faire |
|---|---|---|
| queued | Acceptée, en attente d’un worker | Continuer à interroger |
| processing | Rendu en cours | Continuer à interroger |
| succeeded | Terminée | Lire l’URL dans data et arrêter |
| failed | Échouée | Lire la raison dans error et arrêter. Les crédits sont déjà remboursés |
Conseils d’interrogation
- Toutes les 3 secondes pour l’image (toutes les 5 pour la vidéo, sur son propre point d’accès). Plus souvent ne fait que consommer la limite d’appels sans accélérer quoi que ce soit.
- Fixez un plafond (par exemple 10 minutes pour l’image, 30 pour la vidéo) et traitez-le comme un dépassement de délai. Jamais de boucle infinie.
- Inutile de maintenir le processus en vie : un service d’arrière-plan clôture les tâches abandonnées et rembourse les échecs.
Une tâche n’est visible que par le compte qui l’a créée. La tâche d’autrui et une tâche inexistante renvoient exactement le même 404.