Skip to main content
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>"
}
Use this endpoint after you already have a Replicate prediction id. It reports the current task state and returns output URLs when the prediction completes.

​
Check these fields first

  • status to see whether the prediction is still running or already finished
  • output for generated asset URLs
  • error for provider-side failures
  • metrics when you need execution timing or image-count details

​
Polling pattern

1

Create the prediction first

Start with Create Predictions - General.
2

Poll by prediction id

Keep querying until status becomes terminal and output is either populated or a provider error is returned.
3

Persist finished assets

Treat returned asset URLs as delivery URLs and move them into your own storage if you need long retention.
During live validation on 2026-03-12, the CometAPI query wrapper did not return within a 45-second smoke-test window. Verify polling latency in your own environment before you depend on tight loops.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Path Parameters

​
id
string
required

Prediction id returned by the create endpoint.

Response

200 - application/json

Current prediction state.

​
id
string
required
​
input
object
required
​
model
string
required
​
output
string[] | null
required
​
status
string
required
​
created_at
string
required
​
data_removed
boolean
required
​
logs
string
​
urls
object
​
error
string | null
​
metrics
object
​
version
string
​
started_at
string | null
​
completed_at
string | null