Chuyển đến nội dung chính
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>"
}
Sử dụng endpoint này sau khi bạn đã có một prediction id của Replicate. Endpoint sẽ báo cáo trạng thái hiện tại của tác vụ và trả về các URL output khi prediction hoàn tất.

​
Hãy kiểm tra các trường này trước

  • status để xem prediction vẫn đang chạy hay đã hoàn tất
  • output cho các URL tài nguyên được tạo ra
  • error cho các lỗi từ phía provider
  • metrics khi bạn cần thời gian thực thi hoặc thông tin chi tiết về số lượng ảnh

​
Mẫu polling

1

Tạo prediction trước

Bắt đầu với Create Predictions - General.
2

Poll theo prediction id

Tiếp tục truy vấn cho đến khi status chuyển sang trạng thái kết thúc và output đã được điền hoặc có lỗi từ provider được trả về.
3

Lưu trữ các tài nguyên đã hoàn tất

Coi các URL tài nguyên được trả về là URL phân phối và chuyển chúng vào hệ thống lưu trữ của riêng bạn nếu cần lưu giữ lâu dài.
Trong quá trình xác thực trực tiếp vào ngày 2026-03-12, wrapper truy vấn của CometAPI đã không trả về trong khoảng thời gian smoke-test 45 giây. Hãy xác minh độ trễ polling trong môi trường của riêng bạn trước khi phụ thuộc vào các vòng lặp chặt.

Ủy quyền

​
Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Tham số đường dẫn

​
id
string
bắt buộc

Prediction id returned by the create endpoint.

Phản hồi

200 - application/json

Current prediction state.

​
id
string
bắt buộc
​
input
object
bắt buộc
​
model
string
bắt buộc
​
output
string[] | null
bắt buộc
​
status
string
bắt buộc
​
created_at
string
bắt buộc
​
data_removed
boolean
bắt buộc
​
logs
string
​
urls
object
​
error
string | null
​
metrics
object
​
version
string
​
started_at
string | null
​
completed_at
string | null