Перейти к основному содержанию
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>"
}
Используйте этот endpoint, когда у вас уже есть id prediction Replicate. Он сообщает текущее состояние задачи и возвращает URL результата после завершения prediction.

Сначала проверьте эти поля

  • status, чтобы понять, prediction всё ещё выполняется или уже завершён
  • output для URL сгенерированных ресурсов
  • error для ошибок на стороне провайдера
  • metrics, если вам нужны сведения о времени выполнения или количестве изображений

Шаблон polling

1

Сначала создайте prediction

Начните с Create Predictions - General.
2

Выполняйте polling по id prediction

Продолжайте отправлять запросы, пока status не перейдёт в терминальное состояние, а output не будет заполнен или не вернётся ошибка провайдера.
3

Сохраняйте готовые ресурсы

Считайте возвращённые URL ресурсов URL доставки и перемещайте их в собственное хранилище, если вам нужно долгосрочное хранение.
Во время live-проверки 2026-03-12 обёртка запроса CometAPI не вернула ответ в пределах 45-секундного окна smoke-теста. Проверьте задержку polling в своей среде, прежде чем полагаться на короткие циклы опроса.

Авторизации

Authorization
string
header
обязательно

Bearer token authentication. Use your CometAPI key.

Параметры пути

id
string
обязательно

Prediction id returned by the create endpoint.

Ответ

200 - application/json

Current prediction state.

id
string
обязательно
input
object
обязательно
model
string
обязательно
output
string[] | null
обязательно
status
string
обязательно
created_at
string
обязательно
data_removed
boolean
обязательно
logs
string
urls
object
error
string | null
metrics
object
version
string
started_at
string | null
completed_at
string | null