Statut de requête Replicate

Interrogez GET /replicate/v1/predictions/ pour récupérer les détails d’une prédiction Replicate et sa progression en temps réel par ID de tâche pour les workflows de génération d’images.

GET /replicate/v1/predictions/{id}

Query a Replicate prediction

cURL

curl --request GET \
  --url https://api.cometapi.com/replicate/v1/predictions/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "<string>",
  "input": {},
  "model": "<string>",
  "output": [
    "<string>"
  ],
  "status": "<string>",
  "created_at": "<string>",
  "data_removed": true,
  "logs": "<string>",
  "urls": {
    "get": "<string>",
    "cancel": "<string>",
    "stream": "<string>"
  },
  "error": "<string>",
  "metrics": {
    "image_count": 123,
    "predict_time": 123
  },
  "version": "<string>",
  "started_at": "<string>",
  "completed_at": "<string>"
}

Utilisez ce endpoint une fois que vous disposez déjà d’un ID de prédiction Replicate. Il indique l’état actuel de la tâche et renvoie les URL de sortie lorsque la prédiction est terminée.

​

Vérifiez d’abord ces champs

• status pour voir si la prédiction est encore en cours d’exécution ou déjà terminée
• output pour les URL des ressources générées
• error pour les échecs côté fournisseur
• metrics lorsque vous avez besoin des temps d’exécution ou du détail du nombre d’images

​

Modèle d’interrogation

1. Créez d’abord la prédiction

   Commencez par Create Predictions - General.

2. Interrogez par ID de prédiction

   Continuez à interroger jusqu’à ce que status atteigne un état terminal et que output soit soit renseigné, soit qu’une erreur du fournisseur soit renvoyée.

3. Conservez les ressources finalisées

   Traitez les URL des ressources renvoyées comme des URL de livraison et déplacez-les vers votre propre stockage si vous avez besoin d’une conservation longue durée.

Lors d’une validation en conditions réelles le 2026-03-12, le wrapper de requête CometAPI n’a pas répondu dans une fenêtre de smoke test de 45 secondes. Vérifiez la latence d’interrogation dans votre propre environnement avant de dépendre de boucles serrées.

Autorisations

Authorization · string · header · requis

Bearer token authentication. Use your CometAPI key.

Paramètres de chemin

id · string · requis

Prediction id returned by the create endpoint.

Réponse

200 - application/json

Current prediction state.

id · string · requis

input · object · requis

model · string · requis

output · string[] | null · requis

status · string · requis

created_at · string · requis

data_removed · boolean · requis

logs · string

urls · object

Show child attributes

error · string | null

metrics · object

Show child attributes

version · string

started_at · string | null

completed_at · string | null