Aller au contenu
Cheapest Imagen
Référence de l’API

Lire une tâche

Lit l’état d’une requête asynchrone à partir de son identifiant de tâche : `in_progress`, puis `succeeded` avec les images ou `failed` avec l’erreur. Une tâche peut être lue tant que ses images sont conservées, soit 72 heures. Interrogez toutes les quelques secondes ; lire une tâche ne compte pas comme une requête en cours. Pour attendre plusieurs tâches, utilisez `GET /images/tasks?ids=` et lisez-les en un seul appel.

GET
/images/tasks/{id}

Lit l’état d’une requête asynchrone à partir de son identifiant de tâche : in_progress, puis succeeded avec les images ou failed avec l’erreur. Une tâche peut être lue tant que ses images sont conservées, soit 72 heures. Interrogez toutes les quelques secondes ; lire une tâche ne compte pas comme une requête en cours. Pour attendre plusieurs tâches, utilisez GET /images/tasks?ids= et lisez-les en un seul appel.

Authorization

apiKey
headerAuthorizationBearer <token>

Votre clé API, envoyée sous la forme Authorization: Bearer <key>.

Path Parameters

id*string

L’identifiant de la tâche : l’id de la réponse 202, qui est aussi son x-request-id.

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

Response Body

La tâche.

application/json
  1. response
id*string

L’identifiant de la tâche : l’id de la réponse 202, qui est aussi son x-request-id.

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

in_progress jusqu’à la fin de la requête, puis succeeded ou failed.

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

Moment d’acceptation de la requête, sous forme d’horodatage Unix en secondes.

finished*|

Moment de sa fin, ou null tant qu’elle est en cours.

model*string
result?

Présent quand succeeded : ce que l’appel synchrone aurait renvoyé.

error?

Présent quand failed : l’erreur que l’appel synchrone aurait renvoyée. Une tâche échouée n’est pas facturée, sauf un refus sur les canaux stables 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"  }}