本文へスキップ
Cheapest Imagen
API リファレンス

タスクを取得

非同期リクエスト 1 件の状態を、タスク ID で取得します。`in_progress` のあと、画像とともに `succeeded`、またはエラーとともに `failed` になります。タスクは、画像が保存されている 72 時間のあいだ取得できます。数秒おきにポーリングしてください。タスクの取得は、処理中のリクエストには数えられません。複数のタスクを待つ場合は、`GET /images/tasks?ids=` で 1 回にまとめて取得できます。

GET
/images/tasks/{id}

非同期リクエスト 1 件の状態を、タスク ID で取得します。in_progress のあと、画像とともに succeeded、またはエラーとともに failed になります。タスクは、画像が保存されている 72 時間のあいだ取得できます。数秒おきにポーリングしてください。タスクの取得は、処理中のリクエストには数えられません。複数のタスクを待つ場合は、GET /images/tasks?ids= で 1 回にまとめて取得できます。

Authorization

apiKey
headerAuthorizationBearer <token>

API キー。Authorization: Bearer <key> として送信します。

Path Parameters

id*string

タスク ID。202 のレスポンスの id で、x-request-id と同じ値です。

Match^req_[0-9a-f]{24}$

Response Body

タスク。

application/json
  1. response
id*string

タスク ID。202 のレスポンスの id で、x-request-id と同じ値です。

object*"image.task"
Value in"image.task"
status*string

リクエストが終わるまでは in_progress、終わると succeeded または failed。

Value in"in_progress""succeeded""failed"
created*integer

リクエストを受け付けた日時(Unix タイムスタンプ、秒)。

finished*|

終了した日時。処理中は null。

model*string
result?

succeeded のときに含まれます。同期呼び出しで返るはずのものです。

error?

failed のときに含まれます。同期呼び出しで返るはずのエラーです。失敗したタスクは課金されません(Nano Banana の stable チャンネルでの拒否を除く)。

Example Request
curl -X GET 'https://api.cheapestimagen.com/v1/images/tasks/string'
Example Response
{  "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"  }}