Passer au contenu principal
GET
/
replicate
/
v1
/
predictions
/
{id}
Query a Replicate prediction
curl --request GET \
  --url https://api.cometapi.com/replicate/v1/predictions/{id} \
  --header 'Authorization: Bearer <token>'
{
  "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

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
error
string | null
metrics
object
version
string
started_at
string | null
completed_at
string | null