Получить задачу
Возвращает состояние одного асинхронного запроса по id задачи: `in_progress`, затем `succeeded` с изображениями или `failed` с ошибкой. Задачу можно читать, пока хранятся её изображения, то есть 72 часа. Опрашивайте раз в несколько секунд; чтение задачи не считается запросом в работе. Чтобы дождаться нескольких задач, используйте `GET /images/tasks?ids=` и читайте их одним вызовом.
Возвращает состояние одного асинхронного запроса по id задачи: in_progress, затем succeeded с изображениями или failed с ошибкой. Задачу можно читать, пока хранятся её изображения, то есть 72 часа. Опрашивайте раз в несколько секунд; чтение задачи не считается запросом в работе. Чтобы дождаться нескольких задач, используйте GET /images/tasks?ids= и читайте их одним вызовом.
apiKeyAuthorizationBearer <token>Ваш API-ключ, передаётся как Authorization: Bearer <key>.
id*stringId задачи: id из ответа 202, он же x-request-id.
^req_[0-9a-f]{24}$Задача.
application/json- response
id*stringId задачи: id из ответа 202, он же x-request-id.
object*"image.task""image.task"status*stringin_progress, пока запрос не завершился, затем succeeded или failed.
"in_progress""succeeded""failed"created*integerКогда запрос принят, в виде Unix-времени в секундах.
finished*|Когда завершился, или null, пока выполняется.
model*stringresult?Есть при succeeded: то, что вернул бы синхронный вызов.
error?Есть при failed: ошибка, которую вернул бы синхронный вызов. За неудачную задачу кредиты не списываются, кроме отказа на стабильных каналах Nano Banana.
curl -X GET 'https://api.cheapestimagen.com/v1/images/tasks/string'{ "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" }}Изменить изображение POST
Создаёт изображения по промпту и одному или нескольким опорным изображениям, отправленным файлами в multipart-форме или ссылками.
Получить несколько задач GET
Возвращает состояние до 100 асинхронных запросов одним вызовом, так что страница, отправившая 10 запросов, опрашивает все 10 за один раз. Используйте его вместо отдельного запроса на каждую задачу, когда ждёте несколько. Задачи возвращаются в запрошенном порядке; id, который не относится к задачам вашего аккаунта или уже не хранится, попадает в `not_found` и не приводит к ошибке всего вызова.