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. 先创建预测

   从 Create Predictions - General 开始。

2. 按 prediction id 轮询

   持续查询，直到 status 变为终态，并且 output 已填充，或返回提供方错误。

3. 持久化已完成的资产

   将返回的资产 URL 视为交付 URL；如果你需要长期保留，请将其转存到你自己的存储中。

在 2026-03-12 的实时验证期间，CometAPI 查询封装器在 45 秒的冒烟测试窗口内未返回结果。在依赖高频轮询之前，请先在你自己的环境中验证轮询延迟。

授权

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