Replicate 查詢狀態

透過任務 ID 查詢 GET /replicate/v1/predictions/，以取得 Replicate 預測詳細資訊與影像生成工作流程的即時進度。

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

當你已經擁有 Replicate prediction id 後，請使用此端點。它會回報目前的任務狀態，並在預測完成時回傳輸出 URL。

​

先檢查這些欄位

• status：查看預測仍在執行中還是已經完成
• output：查看生成資產的 URL
• error：查看供應商端失敗資訊
• metrics：當你需要執行時間或影像數量等詳細資訊時使用

​

輪詢模式

1. 先建立 prediction

   從 Create Predictions - General 開始。

2. 依 prediction id 輪詢

   持續查詢，直到 status 進入終態，且 output 已填入，或回傳供應商錯誤為止。

3. 保存完成的資產

   將回傳的資產 URL 視為交付 URL；如果你需要長期保存，請移轉到你自己的儲存空間。

在 2026-03-12 的即時驗證期間，CometAPI 查詢包裝器在 45 秒的 smoke-test 視窗內未返回結果。在依賴高頻輪詢之前，請先在你自己的環境中驗證輪詢延遲。

授權

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

Show child attributes

error · string | null

metrics · object

Show child attributes

version · string

started_at · string | null

completed_at · string | null