Zum Inhalt springen
Cheapest Imagen
API-Referenz

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.

POST
/images/generations

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.

Authorization

apiKey
headerAuthorizationBearer <token>

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

Header Parameters

Idempotency-Key?string

Ein Wert Ihrer Wahl, bis zu 255 Zeichen. Wird derselbe Wert erneut gesendet, entsteht und berechnet keine zweite Anfrage; stattdessen wird 409 zurückgegeben.

Lengthlength <= 255

Request Body

application/json
  1. body
model*string

Das zu verwendende Modell.

Value in"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*string

Was das Bild zeigen soll. Bis zu 32.000 Zeichen.

Lengthlength <= 32000
n?integer

Wie 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.

Range1 <= value <= 10
Default1
size?string

auto 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.

Default"auto"
Value in"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?string

Renderqualitä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.

Default"auto"
Value in"auto""low""medium""high""xhigh""max"
background?string

Derzeit erzeugt kein Modell einen transparenten Hintergrund, transparent liefert also 400. auto und opaque funktionieren bei jedem Modell.

Default"auto"
Value in"auto""opaque"
output_format?string

Dateiformat 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.

Default"png"
Value in"png""jpeg""webp""gif""svg"
output_compression?integer

Qualität für jpeg und webp, von 0 bis 100. Standard 100.

Range0 <= value <= 100
moderation?string

Wie streng der Prompt und das Ergebnis geprüft werden. low ist weniger restriktiv.

Default"auto"
Value in"auto""low"
response_format?string

b64_json liefert die Bilddaten in der Antwort. url liefert einen Link zum Bild, der 72 Stunden gültig bleibt.

Default"b64_json"
Value in"b64_json""url"
async?boolean

Auf 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.

Defaultfalse
webhook_url?string

Mit 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.

Formaturi
webhook_secret?string

Mit 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.

Length16 <= length <= 128

Response Body

Die Bilder.

application/json
  1. response
created*integer

Wann die Bilder erstellt wurden, als Unix-Zeitstempel in Sekunden.

data*array<>
Example Request
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"}'
Example Response
{  "created": 0,  "data": [    {      "b64_json": "string",      "url": "http://example.com"    }  ]}