Pular para o conteúdo
Cheapest Imagen
Referência da API

Obter tarefa

Obtém o estado de uma requisição assíncrona pelo id da tarefa: `in_progress`, depois `succeeded` com as imagens ou `failed` com o erro. Uma tarefa pode ser lida enquanto suas imagens forem guardadas, 72 horas. Consulte a cada poucos segundos; ler uma tarefa não conta como requisição em andamento. Para esperar várias tarefas, use `GET /images/tasks?ids=` e leia todas em uma só chamada.

GET
/images/tasks/{id}

Obtém o estado de uma requisição assíncrona pelo id da tarefa: in_progress, depois succeeded com as imagens ou failed com o erro. Uma tarefa pode ser lida enquanto suas imagens forem guardadas, 72 horas. Consulte a cada poucos segundos; ler uma tarefa não conta como requisição em andamento. Para esperar várias tarefas, use GET /images/tasks?ids= e leia todas em uma só chamada.

Authorization

apiKey
headerAuthorizationBearer <token>

Sua chave de API, enviada como Authorization: Bearer <key>.

Path Parameters

id*string

O id da tarefa: o id da resposta 202, que também é o seu x-request-id.

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

Response Body

A tarefa.

application/json
  1. response
id*string

O id da tarefa: o id da resposta 202, que também é o seu x-request-id.

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

in_progress até a requisição terminar, depois succeeded ou failed.

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

Quando a requisição foi aceita, como timestamp Unix em segundos.

finished*|

Quando terminou, ou null enquanto está em andamento.

model*string
result?

Presente quando succeeded: o que a chamada síncrona teria devolvido.

error?

Presente quando failed: o erro que a chamada síncrona teria devolvido. Uma tarefa que falhou não é cobrada, exceto uma recusa nos canais estáveis do 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"  }}