Consultar estado de Replicate

Consulta GET /replicate/v1/predictions/ para obtener los detalles de una predicción de Replicate y el progreso en tiempo real por ID de tarea para flujos de trabajo de generación de imágenes.

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 este endpoint después de que ya tengas un id de predicción de Replicate. Informa el estado actual de la tarea y devuelve las URL de salida cuando la predicción se completa.

​

Revisa primero estos campos

• status para ver si la predicción sigue ejecutándose o ya terminó
• output para las URL de los recursos generados
• error para fallos del lado del proveedor
• metrics cuando necesites tiempos de ejecución o detalles del número de imágenes

​

Patrón de sondeo

1. Primero crea la predicción

   Comienza con Create Predictions - General.

2. Haz sondeo por prediction id

   Sigue consultando hasta que status pase a un estado terminal y output se complete o se devuelva un error del proveedor.

3. Conserva los recursos finalizados

   Trata las URL de los recursos devueltos como URL de entrega y muévelas a tu propio almacenamiento si necesitas retención prolongada.

Durante la validación en vivo del 2026-03-12, el wrapper de consulta de CometAPI no devolvió una respuesta dentro de una ventana de smoke test de 45 segundos. Verifica la latencia del sondeo en tu propio entorno antes de depender de bucles ajustados.

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication. Use your CometAPI key.

Parámetros de ruta

id · string · requerido

Prediction id returned by the create endpoint.

Respuesta

200 - application/json

Current prediction state.

id · string · requerido

input · object · requerido

model · string · requerido

output · string[] | null · requerido

status · string · requerido

created_at · string · requerido

data_removed · boolean · requerido

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