Status Query Replicate

Lakukan query GET /replicate/v1/predictions/ untuk mengambil detail prediksi Replicate dan progres real-time berdasarkan ID task untuk alur kerja pembuatan gambar.

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

Gunakan endpoint ini setelah Anda sudah memiliki prediction id Replicate. Endpoint ini melaporkan status task saat ini dan mengembalikan URL output saat prediction selesai.

​

Periksa field ini terlebih dahulu

• status untuk melihat apakah prediction masih berjalan atau sudah selesai
• output untuk URL aset yang dihasilkan
• error untuk kegagalan di sisi provider
• metrics saat Anda memerlukan detail waktu eksekusi atau jumlah gambar

​

Pola polling

1. Buat prediction terlebih dahulu

   Mulai dengan Create Predictions - General.

2. Lakukan polling berdasarkan prediction id

   Terus lakukan query hingga status menjadi terminal dan output sudah terisi atau error dari provider dikembalikan.

3. Simpan aset yang sudah selesai

   Perlakukan URL aset yang dikembalikan sebagai URL pengiriman dan pindahkan ke penyimpanan Anda sendiri jika Anda memerlukan retensi jangka panjang.

Selama validasi langsung pada 2026-03-12, wrapper query CometAPI tidak mengembalikan respons dalam jendela smoke-test 45 detik. Verifikasi latensi polling di lingkungan Anda sendiri sebelum Anda mengandalkan loop yang ketat.

Otorisasi

Authorization · string · header · wajib

Bearer token authentication. Use your CometAPI key.

Parameter Path

id · string · wajib

Prediction id returned by the create endpoint.

Respons

200 - application/json

Current prediction state.

id · string · wajib

input · object · wajib

model · string · wajib

output · string[] | null · wajib

status · string · wajib

created_at · string · wajib

data_removed · boolean · wajib

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