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.
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.
apiKeyAuthorizationBearer <token>Ihr API-Schlüssel, gesendet als Authorization: Bearer <key>.
id*stringDie Task-ID: die id der Antwort 202, die zugleich ihre x-request-id ist.
^req_[0-9a-f]{24}$Der Task.
application/json- response
id*stringDie Task-ID: die id der Antwort 202, die zugleich ihre x-request-id ist.
object*"image.task""image.task"status*stringin_progress, bis die Anfrage endet, dann succeeded oder failed.
"in_progress""succeeded""failed"created*integerWann die Anfrage angenommen wurde, als Unix-Zeitstempel in Sekunden.
finished*|Wann sie endete, oder null, solange sie läuft.
model*stringresult?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.
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" }}Bild bearbeiten POST
Erstellt Bilder aus einem Prompt und einem oder mehreren Referenzbildern, gesendet als Dateien in einem Multipart-Formular oder als Links.
Mehrere Tasks abrufen GET
Ruft den Zustand von bis zu 100 asynchronen Anfragen in einem Aufruf ab, sodass eine Seite, die 10 Anfragen gesendet hat, einmal für alle 10 abfragt. Nutzen Sie es statt einer Anfrage pro Task, wenn Sie auf mehrere warten. Die Tasks kommen in der angefragten Reihenfolge zurück; eine ID, die kein Task Ihres Kontos ist oder nicht mehr gespeichert wird, steht in `not_found` und lässt den Aufruf nicht fehlschlagen.