查詢出圖任務
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。