查询出图任务

GET /v1/tasks/{id}

查询出图任务的状态，仅在生图时显式传了 async: true 才用得上（默认同步的调用直接在响应里就拿到图了）。出片任务不走这里，走 GET /v1/video/generations/{task_id}。

请求

bash

curl https://open.pikpikgo.com/v1/tasks/2608101909450810293847 \
  -H "Authorization: Bearer $PIKPIK_API_KEY"

json

{
  "id": "2608101909450810293847",
  "object": "image.generation",
  "created": 1786000185,
  "model": "img-std-1",
  "status": "succeeded",
  "prompt": "赛博朋克风格的雨夜街道，霓虹倒影",
  "size": "16:9",
  "quality": "2k",
  "credits": 10,
  "error": "",
  "data": [
    { "url": "https://cdn.pikpikgo.com/ai/xxxx.png", "revised_prompt": "赛博朋克风格的雨夜街道，霓虹倒影" }
  ]
}

状态流转

status	含义	该怎么做
queued	已入队，等待渲染	继续轮询
processing	渲染中	继续轮询
succeeded	已完成	从 data 里取产物地址，停止轮询
failed	已失败	看 error 字段的原因，停止轮询。算力已自动退还

轮询建议

出图 3 秒一次即可（出片建议 5 秒一次，走各自的查询端点）。更密只会消耗频控额度，不会让任务变快。
设一个上限（例如出图 10 分钟、出片 30 分钟），到点当超时处理，不要无限循环。
不必担心「关掉进程任务就丢了」：平台有后台兜底，会把无人推进的任务收尾，失败的自动退还算力。

任务只能被创建它的那个账号查询。查询别人的任务与查询不存在的任务，返回完全一样的 404。