跳到內文
Cheapest Imagen
API 參考

批次查詢任務

一次查詢最多 100 個非同步請求的狀態。同時在等多個任務時用它,不要每個任務送一個請求:頁面送出了 10 個請求,輪詢一次就能拿到 10 個的狀態。任務按你給的順序回傳;不屬於你帳號的任務編號、或者已過保存期的,會列在 `not_found` 裡,不會讓整個請求失敗。

GET
/images/tasks

一次查詢最多 100 個非同步請求的狀態。同時在等多個任務時用它,不要每個任務送一個請求:頁面送出了 10 個請求,輪詢一次就能拿到 10 個的狀態。任務按你給的順序回傳;不屬於你帳號的任務編號、或者已過保存期的,會列在 not_found 裡,不會讓整個請求失敗。

Authorization

apiKey
headerAuthorizationBearer <token>

你的 API 金鑰,放在請求標頭裡:Authorization: Bearer <金鑰>。

Query Parameters

ids*string

任務編號,用逗號分隔,最多 100 個。也可以重複這個參數(ids=a&ids=b)。

Response Body

查到的任務,以及沒查到的任務編號。

application/json
  1. response
object*"list"
Value in"list"
data*array<>

任務清單,順序和 ids 一致。

not_found*array<string>

不屬於這個帳號、或者已過保存期的任務編號。

Example Request
curl -X GET 'https://api.cheapestimagen.com/v1/images/tasks?ids=req_33ac10d3e9a8e6f120f4c0d3%2Creq_26e50328772b7d62f59d355a'
Example Response
{  "object": "list",  "data": [    {      "id": "string",      "object": "image.task",      "status": "in_progress",      "created": 0,      "finished": 0,      "model": "string",      "result": {        "created": 0,        "data": [          {            "b64_json": "string",            "url": "http://example.com"          }        ]      },      "error": {        "message": "string",        "type": "string",        "param": "string",        "code": "string"      }    }  ],  "not_found": [    "string"  ]}