Перейти к содержимому
Cheapest Imagen
Справочник API

Получить задачу

Возвращает состояние одного асинхронного запроса по id задачи: `in_progress`, затем `succeeded` с изображениями или `failed` с ошибкой. Задачу можно читать, пока хранятся её изображения, то есть 72 часа. Опрашивайте раз в несколько секунд; чтение задачи не считается запросом в работе. Чтобы дождаться нескольких задач, используйте `GET /images/tasks?ids=` и читайте их одним вызовом.

GET
/images/tasks/{id}

Возвращает состояние одного асинхронного запроса по id задачи: in_progress, затем succeeded с изображениями или failed с ошибкой. Задачу можно читать, пока хранятся её изображения, то есть 72 часа. Опрашивайте раз в несколько секунд; чтение задачи не считается запросом в работе. Чтобы дождаться нескольких задач, используйте GET /images/tasks?ids= и читайте их одним вызовом.

Authorization

apiKey
headerAuthorizationBearer <token>

Ваш API-ключ, передаётся как Authorization: Bearer <key>.

Path Parameters

id*string

Id задачи: id из ответа 202, он же x-request-id.

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

Response Body

Задача.

application/json
  1. response
id*string

Id задачи: id из ответа 202, он же 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.

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"  }}