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.
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.
apiKeyAuthorizationBearer <token>Votre clé API, envoyée sous la forme Authorization: Bearer <key>.
id*stringL’identifiant de la tâche : l’id de la réponse 202, qui est aussi son x-request-id.
^req_[0-9a-f]{24}$La tâche.
application/json- response
id*stringL’identifiant de la tâche : l’id de la réponse 202, qui est aussi son x-request-id.
object*"image.task""image.task"status*stringin_progress jusqu’à la fin de la requête, puis succeeded ou failed.
"in_progress""succeeded""failed"created*integerMoment 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*stringresult?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.
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" }}Modifier une image POST
Crée des images à partir d’un prompt et d’une ou plusieurs images de référence, envoyées en fichiers dans un formulaire multipart ou en liens.
Lire plusieurs tâches GET
Lit l’état de 100 requêtes asynchrones au plus en un seul appel, de sorte qu’une page qui a envoyé 10 requêtes interroge une seule fois pour les 10. Utilisez-le plutôt qu’une requête par tâche quand vous en attendez plusieurs. Les tâches reviennent dans l’ordre demandé ; un identifiant qui n’est pas une tâche de votre compte, ou qui n’est plus conservé, figure dans `not_found` et ne fait pas échouer l’appel.