Zum Inhalt springen
Cheapest Imagen
API-Referenz

Task abrufen

Ruft den Zustand einer asynchronen Anfrage anhand ihrer Task-ID ab: `in_progress`, dann `succeeded` mit den Bildern oder `failed` mit dem Fehler. Ein Task lässt sich so lange lesen, wie seine Bilder gespeichert sind, 72 Stunden. Fragen Sie alle paar Sekunden ab; das Lesen eines Tasks zählt nicht als laufende Anfrage. Um auf mehrere Tasks zu warten, nutzen Sie `GET /images/tasks?ids=` und lesen Sie sie in einem Aufruf.

GET
/images/tasks/{id}

Ruft den Zustand einer asynchronen Anfrage anhand ihrer Task-ID ab: in_progress, dann succeeded mit den Bildern oder failed mit dem Fehler. Ein Task lässt sich so lange lesen, wie seine Bilder gespeichert sind, 72 Stunden. Fragen Sie alle paar Sekunden ab; das Lesen eines Tasks zählt nicht als laufende Anfrage. Um auf mehrere Tasks zu warten, nutzen Sie GET /images/tasks?ids= und lesen Sie sie in einem Aufruf.

Authorization

apiKey
headerAuthorizationBearer <token>

Ihr API-Schlüssel, gesendet als Authorization: Bearer <key>.

Path Parameters

id*string

Die Task-ID: die id der Antwort 202, die zugleich ihre x-request-id ist.

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

Response Body

Der Task.

application/json
  1. response
id*string

Die Task-ID: die id der Antwort 202, die zugleich ihre x-request-id ist.

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

in_progress, bis die Anfrage endet, dann succeeded oder failed.

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

Wann die Anfrage angenommen wurde, als Unix-Zeitstempel in Sekunden.

finished*|

Wann sie endete, oder null, solange sie läuft.

model*string
result?

Vorhanden bei succeeded: was der synchrone Aufruf zurückgegeben hätte.

error?

Vorhanden bei failed: der Fehler, den der synchrone Aufruf zurückgegeben hätte. Ein fehlgeschlagener Task wird nicht berechnet, außer bei einer Ablehnung auf den Stable-Kanälen von 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"  }}