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.
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.
apiKeyAuthorizationBearer <token>Sua chave de API, enviada como Authorization: Bearer <key>.
id*stringO id da tarefa: o id da resposta 202, que também é o seu x-request-id.
^req_[0-9a-f]{24}$A tarefa.
application/json- response
id*stringO id da tarefa: o id da resposta 202, que também é o seu x-request-id.
object*"image.task""image.task"status*stringin_progress até a requisição terminar, depois succeeded ou failed.
"in_progress""succeeded""failed"created*integerQuando a requisição foi aceita, como timestamp Unix em segundos.
finished*|Quando terminou, ou null enquanto está em andamento.
model*stringresult?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.
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" }}Editar imagem POST
Cria imagens a partir de um prompt e de uma ou mais imagens de referência, enviadas como arquivos em um formulário multipart ou como links.
Obter várias tarefas GET
Obtém o estado de até 100 requisições assíncronas em uma só chamada, para que uma página que enviou 10 requisições consulte uma vez por todas as 10. Use no lugar de uma requisição por tarefa quando estiver esperando várias. As tarefas voltam na ordem pedida; um id que não é uma tarefa da sua conta, ou que não é mais guardado, aparece em `not_found` e não faz a chamada falhar.