Stato della query Replicate

Interroga GET /replicate/v1/predictions/ per recuperare i dettagli della prediction di Replicate e l’avanzamento in tempo reale per ID attività nei flussi di lavoro di generazione di immagini.

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>"
}

Usa questo endpoint dopo avere già ottenuto un prediction id di Replicate. Riporta lo stato corrente dell’attività e restituisce gli URL di output quando la prediction è completata.

​

Controlla prima questi campi

• status per vedere se la prediction è ancora in esecuzione o è già terminata
• output per gli URL delle risorse generate
• error per gli errori lato provider
• metrics quando ti servono i tempi di esecuzione o i dettagli sul numero di immagini

​

Pattern di polling

1. Crea prima la prediction

   Inizia con Create Predictions - General.

2. Esegui il polling tramite prediction id

   Continua a interrogare finché status non diventa terminale e output non viene popolato oppure non viene restituito un errore del provider.

3. Salva le risorse completate

   Considera gli URL delle risorse restituiti come URL di delivery e spostali nel tuo storage se hai bisogno di una conservazione a lungo termine.

Durante la convalida live del 2026-03-12, il wrapper di query di CometAPI non ha restituito una risposta entro una finestra di smoke test di 45 secondi. Verifica la latenza del polling nel tuo ambiente prima di fare affidamento su loop ravvicinati.

Autorizzazioni

Authorization · string · header · obbligatorio

Bearer token authentication. Use your CometAPI key.

Parametri del percorso

id · string · obbligatorio

Prediction id returned by the create endpoint.

Risposta

200 - application/json

Current prediction state.

id · string · obbligatorio

input · object · obbligatorio

model · string · obbligatorio

output · string[] | null · obbligatorio

status · string · obbligatorio

created_at · string · obbligatorio

data_removed · boolean · obbligatorio

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