Bild erstellen
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.
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.
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 <= 255application/json- 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 <= 128Die 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/generations' \ -H 'Content-Type: application/json' \ -d '{ "model": "gpt-image-2", "prompt": "a red fox in the snow", "size": "1536x1024"}'{ "created": 0, "data": [ { "b64_json": "string", "url": "http://example.com" } ]}Mit n8n nutzen
Erstellen Sie Bilder in einem n8n-Workflow mit GPT Image oder Nano Banana über die Cheapest Imagen API und den Knoten HTTP Request. Einstellungen, Request-Body.
Bild bearbeiten POST
Erstellt Bilder aus einem Prompt und einem oder mehreren Referenzbildern, gesendet als Dateien in einem Multipart-Formular oder als Links.