Bild bearbeiten
Erstellt Bilder aus einem Prompt und einem oder mehreren Referenzbildern, gesendet als Dateien in einem Multipart-Formular oder als Links.
Erstellt Bilder aus einem Prompt und einem oder mehreren Referenzbildern, gesendet als Dateien in einem Multipart-Formular oder als Links.
apiKeyAuthorizationBearer <token>Ihr API-Schlüssel, gesendet als Authorization: Bearer <key>.
Idempotency-Key?stringEin Wert Ihrer Wahl, bis zu 255 Zeichen. Wird derselbe Wert erneut gesendet, entsteht und berechnet keine zweite Anfrage; stattdessen wird 409 zurückgegeben.
length <= 255multipart/form-data- body
model*stringDas zu verwendende Modell.
"gpt-image-2""gpt-image-2-adobe""gpt-image-2.5""gpt-image-2.5-flare""gpt-image-2.5-sunburst""gpt-image-2.6""gpt-image-2.6-flare""gpt-image-2.6-sunburst""nano-banana-2""nano-banana-2.1""nano-banana-pro""nano-banana-2-1k""nano-banana-2-2k""nano-banana-2-4k""nano-banana-pro-1k""nano-banana-pro-2k""nano-banana-pro-4k"prompt*stringWas das Bild zeigen soll. Bis zu 32.000 Zeichen.
length <= 32000n?integerWie viele Bilder erstellt werden. Eine Anfrage verbraucht das n-Fache der Credits des Modells. Höchstens 10 bei 1K, 4 bei 2K und 2 bei 4K.
1 <= value <= 101size?stringauto lässt das Modell wählen (bei einem Modell mit einer Auflösung diese Auflösung). Die anderen Werte sind Größen in 1K, 2K und 4K; jedes Modell akzeptiert die Auflösungen, die auf seiner Karte unter /de/models stehen, zu einem Preis. Das Seitenverhältnis jeder Größe steht in der Anleitung zu Größen. gpt-image-2-adobe und gpt-image-2.5-flare nehmen auch eine eigene Breite und Höhe: Vielfache von 16, bis zu 3840 px pro Seite, nicht länger als 3:1, 655.360 bis 8.294.400 Pixel.
"auto""auto""1024x1024""1536x1024""1024x1536""1443x1090""1090x1443""1672x941""941x1672""1408x1120""1120x1408""1920x832""832x1920""1792x896""896x1792""1152x864""864x1152""1280x720""720x1280""1120x896""896x1120""1456x624""624x1456""1536x768""768x1536""2048x2048""2048x1360""1360x2048""2304x1728""1728x2304""2048x1152""1152x2048""2240x1792""1792x2240""2912x1248""1248x2912""3072x1536""1536x3072""2048x688""688x2048""2880x2880""3504x2336""2336x3504""3264x2448""2448x3264""3840x2160""2160x3840""3200x2560""2560x3200""3840x1648""1648x3840""3840x1920""1920x3840""3840x1280""1280x3840""2048x512""512x2048""3072x384""384x3072""4096x1024""1024x4096""6144x768""768x6144""8192x2048""2048x8192""12288x1536""1536x12288"quality?stringRenderqualität, beachtet von gpt-image-2-adobe und den Varianten flare und sunburst; die anderen GPT-Modelle wählen sie selbst, und Nano Banana ignoriert sie. xhigh und max funktionieren nur bei gpt-image-2.5-sunburst. Jede Qualität kostet gleich viel.
"auto""auto""low""medium""high""xhigh""max"background?stringDerzeit erzeugt kein Modell einen transparenten Hintergrund, transparent liefert also 400. auto und opaque funktionieren bei jedem Modell.
"auto""auto""opaque"output_format?stringDateiformat der zurückgegebenen Bilder. gif funktioniert bei gpt-image-2.6 und seinen Varianten flare und sunburst, svg nur bei gpt-image-2.6. png, jpeg und webp funktionieren bei jedem Modell.
"png""png""jpeg""webp""gif""svg"output_compression?integerQualität für jpeg und webp, von 0 bis 100. Standard 100.
0 <= value <= 100moderation?stringWie streng der Prompt und das Ergebnis geprüft werden. low ist weniger restriktiv.
"auto""auto""low"response_format?stringb64_json liefert die Bilddaten in der Antwort. url liefert einen Link zum Bild, der 72 Stunden gültig bleibt.
"b64_json""b64_json""url"async?booleanAuf true setzen, um die Anfrage im Hintergrund auszuführen. Die Antwort ist sofort 202 mit einem Task; das Ergebnis lesen Sie später mit GET /images/tasks/{id}. Die Bilder werden als Links zurückgegeben, response_format muss also url sein oder weggelassen werden. Der Header Prefer: respond-async bewirkt dasselbe.
falsewebhook_url?stringMit async: eine https://-Adresse, die einen POST mit dem fertigen Task erhält (dasselbe JSON wie GET /images/tasks/{id}). Es wird bis zu 3-mal versucht. Senden Sie webhook_secret, damit der Aufruf signiert wird; ohne es bestätigen Sie das Empfangene, indem Sie den Task mit Ihrem Schlüssel abrufen.
uriwebhook_secret?stringMit webhook_url: ein eigenes Geheimnis, 16 bis 128 Zeichen. Der Aufruf an Ihre Adresse trägt dann x-webhook-signature: t=<unix seconds>,v1=<hex>, wobei der Hex-Wert der HMAC-SHA256 von <t>.<body> mit diesem Geheimnis ist.
16 <= length <= 128image[]*array<>Referenzbilder: PNG, JPEG oder WebP, 1 bis 16 Dateien, je bis zu 20 MB, insgesamt 50 MB.
1 <= items <= 16input_fidelity?stringWie genau das Ergebnis die Details der Referenzbilder beibehält. Wird von gpt-image-2 nicht akzeptiert.
"low""high"Die Bilder.
application/json- response
created*integerWann die Bilder erstellt wurden, als Unix-Zeitstempel in Sekunden.
data*array<>curl -X POST 'https://api.cheapestimagen.com/v1/images/edits' \ -F 'model=gpt-image-2' \ -F 'prompt=string' \ -F 'image[]=[ "string"]'{ "created": 0, "data": [ { "b64_json": "string", "url": "http://example.com" } ]}Bild erstellen POST
Erstellt aus einem Text-Prompt ein oder mehrere Bilder. Credits werden beim Start der Anfrage reserviert und für jedes nicht gelieferte Bild zurückgegeben.
Task abrufen GET
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.