Obtener tarea
Obtiene el estado de una solicitud asíncrona por su id de tarea: `in_progress`, y después `succeeded` con las imágenes o `failed` con el error. Una tarea se puede leer mientras se conserven sus imágenes, 72 horas. Consulta cada pocos segundos; leer una tarea no cuenta como una solicitud en curso. Para esperar varias tareas, usa `GET /images/tasks?ids=` y léelas en una sola llamada.
Obtiene el estado de una solicitud asíncrona por su id de tarea: in_progress, y después succeeded con las imágenes o failed con el error. Una tarea se puede leer mientras se conserven sus imágenes, 72 horas. Consulta cada pocos segundos; leer una tarea no cuenta como una solicitud en curso. Para esperar varias tareas, usa GET /images/tasks?ids= y léelas en una sola llamada.
apiKeyAuthorizationBearer <token>Tu clave de API, enviada como Authorization: Bearer <key>.
id*stringEl id de la tarea: el id de la respuesta 202, que también es su x-request-id.
^req_[0-9a-f]{24}$La tarea.
application/json- response
id*stringEl id de la tarea: el id de la respuesta 202, que también es su x-request-id.
object*"image.task""image.task"status*stringin_progress hasta que termina la solicitud, y después succeeded o failed.
"in_progress""succeeded""failed"created*integerCuándo se aceptó la solicitud, como marca de tiempo Unix en segundos.
finished*|Cuándo terminó, o null mientras está en curso.
model*stringresult?Presente cuando es succeeded: lo que habría devuelto la llamada síncrona.
error?Presente cuando es failed: el error que habría devuelto la llamada síncrona. Una tarea fallida no se cobra, salvo un rechazo en los canales estables de 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 imagen POST
Crea imágenes a partir de un prompt y una o varias imágenes de referencia, enviadas como archivos en un formulario multipart o como enlaces.
Obtener varias tareas GET
Obtiene el estado de hasta 100 solicitudes asíncronas en una sola llamada, de modo que una página que envió 10 solicitudes consulta una vez por las 10. Úsalo en lugar de una solicitud por tarea cuando esperas varias. Las tareas vuelven en el orden pedido; un id que no es una tarea de tu cuenta, o que ya no se conserva, aparece en `not_found` y no hace fallar la llamada.