查询任务

GET `/v1/tasks/{task_id}`

用提交时拿到的 task_id 查任务。响应用平台信封 { code, data }。

curl https://api.jiufeng.ai/v1/tasks/task_01M0CGM9MRSMD6R6PPNQWXQZ77 \
  -H "Authorization: Bearer sk-jf-live-YOUR_KEY"

状态枚举

data.status 只有四个终对外值：

status	含义	是否终态
`pending`	已提交 / 排队中	否
`processing`	生成中	否
`completed`	成功	是
`failed`	失败	是

状态真值是 pending / processing / completed / failed。不要用 queued / success 这类旧口径判断。

响应字段（`data`）

字段	类型	说明
`id`	string	任务 id（即提交时返回的 `task_id`）
`status`	string	`pending` / `processing` / `completed` / `failed`
`progress`	string	进度，如 `100%`
`created`	integer	提交时间（Unix 秒）
`estimated_time`	integer	预估耗时（秒）
`completed`	integer	完成时间（Unix 秒，终态才有）
`actual_time`	integer	实际耗时（秒，终态才有）
`credits_cost`	integer	消耗积分
`result`	object	成功时的结果（见下）
`error`	object	失败时的错误（见下）

result（成功）

字段	类型	说明
`url`	string[]	结果图 URL 数组（平台域名 `token-img.jiufeng.ai`）
`expires_at`	integer	结果图过期时间（Unix 秒，完成后 24 小时）
`image_ids`	string[]	结果图的平台 id

error（失败）：{ message, type, param, code }。

成功示例

{
  "code": 200,
  "data": {
    "id": "task_01M0CGM9MRSMD6R6PPNQWXQZ77",
    "status": "completed",
    "progress": "100%",
    "created": 1785076811,
    "completed": 1785076816,
    "actual_time": 5,
    "credits_cost": 12,
    "result": {
      "url": ["https://token-img.jiufeng.ai/f/image/xxx_0.png"],
      "expires_at": 1785163216,
      "image_ids": ["img_01M0..."]
    }
  }
}

失败示例

{
  "code": 200,
  "data": {
    "id": "task_01M0CGM9MRSMD6R6PPNQWXQZ77",
    "status": "failed",
    "error": {
      "message": "content policy violation",
      "type": "invalid_request_error",
      "param": "prompt",
      "code": "content_policy"
    }
  }
}

轮询建议

指数退避：首次约 1s，逐步拉长到几秒一次；不要高频空转。
结果图 URL 完成后 24 小时过期，请尽快下载 / 转存到你自己的存储。
想彻底省掉轮询，改用 Webhook 回调。

批量查询 `POST /v1/tasks/batch`

一次查多个任务（简化版：每个任务只返回 id 和 status，不含 result）。请求体带 task_ids（task_id 数组，默认上限 500）。除上述四个状态外，批量还可能返回 invalid_id / expired / not_found（标识对应 id 的查询结果）。

curl https://api.jiufeng.ai/v1/tasks/batch \
  -H "Authorization: Bearer sk-jf-live-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "task_ids": ["task_01M0...", "task_02N1..."] }'

{
  "code": 200,
  "data": [
    { "id": "task_01M0...", "status": "completed" },
    { "id": "task_02N1...", "status": "processing" }
  ]
}

想拿结果图，再对 completed 的任务逐个走 GET /v1/tasks/{task_id}。

GET /v1/tasks/{task_id}