跳轉到主要內容
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>"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

先檢查這些欄位

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

輪詢模式

1

先建立 prediction

2

依 prediction id 輪詢

持續查詢,直到 status 變成終態,且 output 已填入內容,或回傳供應商錯誤為止。
3

保存已完成的資產

將回傳的資產 URL 視為交付 URL;如果您需要長期保存,請將其移至您自己的儲存空間。

授權

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