跳到正文
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"  ]}