Skip to main content
GET
/
replicate
/
v1
/
predictions
/
{id}
cURL
curl https://api.deerapi.com/replicate/v1/predictions/<TASK_ID> \
  -H "Authorization: Bearer <DEERAPI_KEY>"
{
  "id": "e6je4zpgdxrmw0cww2xsb0515g",
  "model": "black-forest-labs/flux-1.1-pro",
  "version": "hidden",
  "input": {
    "prompt": "A red paper lantern on a wooden table, studio photo",
    "aspect_ratio": "1:1",
    "output_format": "jpg"
  },
  "logs": "Starting generation...",
  "output": null,
  "data_removed": false,
  "error": null,
  "source": "api",
  "status": "processing",
  "metrics": null,
  "created_at": "2026-03-12T06:28:50.927Z",
  "started_at": "2026-03-12T06:28:52.201Z",
  "completed_at": null,
  "urls": {
    "cancel": "https://api.replicate.com/v1/predictions/e6je4zpgdxrmw0cww2xsb0515g/cancel",
    "get": "https://api.replicate.com/v1/predictions/e6je4zpgdxrmw0cww2xsb0515g",
    "stream": "https://stream.replicate.com/v1/files/example-stream",
    "web": "https://replicate.com/p/e6je4zpgdxrmw0cww2xsb0515g"
  }
}
如果你的创建接口走的是 Replicate 风格,查询阶段最稳的做法就是继续用当前页,把响应一直当成标准 Predictions 对象处理。

查询时先盯住这四个字段

status

先判断 startingprocessingsucceededfailedcanceled

output

只有任务完成后才值得读取。处理中时经常还是 null

logs

适合排查模型是不是在工作、卡在哪一步。

metrics

终态后再看更有意义,例如耗时和图片数量。

推荐的轮询方式

1

创建后保存 id

不要等到查询时再从别的字段反推任务 ID。
2

先按 status 分支

succeeded 才读 outputfailed 先看 errorlogsprocessing 就继续轮询。
3

终态后再处理结果

成功就保存输出地址,失败就记录错误信息,避免把处理中状态当成失败。

什么时候改用统一查询

  • 你的系统同时还有 FLUX 短路径任务。
  • 你更在意少维护一条查询 URL,而不是严格固定返回对象结构。

相关页面

创建任务-通用

使用完整模型 ID 路径创建 Replicate 风格任务。

统一查询 FLUX 与 Replicate

需要一条 URL 同时兼容两类任务时,再切换到统一查询页。

参考文档

Authorizations

Authorization
string
header
required

使用 DeerAPI Key 进行 Bearer Token 鉴权。

Path Parameters

id
string
required

创建任务时返回的任务 ID。

Response

200 - application/json

查询成功

id
string
required
urls
object
required
input
object
required
status
enum<string>
required
Available options:
starting,
processing,
succeeded,
failed,
canceled
created_at
string<date-time>
required
data_removed
boolean
required
logs
string | null
error
model
string
output
metrics
object
version
string
source
enum<string>
Available options:
api,
web
started_at
string<date-time> | null
completed_at
string<date-time> | null