Saltar al contenido
Cheapest Imagen
Referencia de la API

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.

GET
/images/tasks/{id}

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.

Authorization

apiKey
headerAuthorizationBearer <token>

Tu clave de API, enviada como Authorization: Bearer <key>.

Path Parameters

id*string

El id de la tarea: el id de la respuesta 202, que también es su x-request-id.

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

Response Body

La tarea.

application/json
  1. response
id*string

El id de la tarea: el id de la respuesta 202, que también es su x-request-id.

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

in_progress hasta que termina la solicitud, y después succeeded o failed.

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

Cuándo se aceptó la solicitud, como marca de tiempo Unix en segundos.

finished*|

Cuándo terminó, o null mientras está en curso.

model*string
result?

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.

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