Text zu Bild
Erstellen Sie mit der Cheapest Imagen API Bilder aus einem Text-Prompt und wählen Sie Modell, Größe, Qualität, Zahl der Bilder und Dateiformat der Ausgabe.
Senden Sie einen Prompt an POST /v1/images/generations. Nur model und prompt sind erforderlich.
curl https://api.cheapestimagen.com/v1/images/generations \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "a lighthouse at dusk, oil painting",
"n": 2,
"size": "1536x1024",
"quality": "high"
}'Optionen
| Feld | Was es bewirkt | Werte |
|---|---|---|
n | Zahl der Bilder | 1 bis 10, Standard 1 |
size | Breite und Höhe | auto oder eine Größe in 1K, 2K oder 4K, siehe Seitenverhältnisse und Größen |
quality | Renderqualität, für alle derselbe Preis | auto, low, medium, high; xhigh, max bei gpt-image-2.5-sunburst |
background | Transparenter oder einfarbiger Hintergrund | auto, opaque, transparent |
output_format | Dateiformat | png (Standard), jpeg, webp bei jedem Modell; gif bei gpt-image-2.6 und seinen Varianten flare und sunburst; svg bei gpt-image-2.6 |
output_compression | Qualität für jpeg und webp | 0 bis 100, Standard 100 |
moderation | Wie streng die Inhaltsprüfung ist | auto, low |
response_format | Bilddaten oder ein Link | b64_json (Standard), url |
Derzeit erzeugt kein Modell einen transparenten Hintergrund: OpenAI hat die Transparenz-Vorschau für die Modelle von GPT Image zurückgezogen, und sie liefern jetzt einen einfarbigen Hintergrund. Eine Anfrage mit background: transparent liefert 400 mit dem Code unsupported_parameter. Um ein freigestelltes Bild zu erhalten, verlangen Sie im Prompt einen einfarbigen, schlichten Hintergrund und entfernen Sie ihn anschließend.
Ausgabeformate
PNG, JPEG und WebP funktionieren bei jedem Modell, wie bei der API von OpenAI. Die meisten Modelle erzeugen ein PNG, und wir wandeln es im Netzwerk von Cloudflare in das angeforderte JPEG oder WebP um (etwa 0,1 bis 0,4 Sekunden; aus einem PNG mit 2 MB wird ein JPEG oder WebP von etwa 250 KB). gpt-image-2.6-flare und gpt-image-2.6-sunburst erzeugen JPEG und WebP selbst.
| Modell | PNG | JPEG | WebP | GIF | SVG |
|---|---|---|---|---|---|
gpt-image-2, gpt-image-2.5, gpt-image-2-adobe | Ja | Ja | Ja | – | – |
gpt-image-2.6 | Ja | Ja | Ja | Ja | Ja |
gpt-image-2.5-flare, gpt-image-2.5-sunburst | Ja | Ja | Ja | – | – |
gpt-image-2.6-flare, gpt-image-2.6-sunburst | Ja | Ja | Ja | Ja | – |
| Nano Banana (alle Versionen) | Ja | Ja | Ja | – | – |
„–“ liefert 400. output_compression legt bei jedem Modell die Qualität von JPEG oder WebP fest (Standard 100). Ein GIF kann drei bis fünf Minuten dauern. Der tatsächliche Typ der Datei steht in der Endung des Links und in seinem Content-Type.
Wie viele Credits eine Anfrage verbraucht
Eine Anfrage verbraucht das n-Fache der Credits des Modells: 8 pro Bild bei GPT Image 2, 2.5 und 2.6, 12 bei Nano Banana 2 und 2.1, 20 bei Nano Banana Pro, gpt-image-2-adobe und den Varianten flare, 25 bei den Varianten sunburst, 60 bis 180 bei den Stable-Kanälen von Nano Banana. Kommen weniger Bilder zurück als angefordert, zahlen Sie nur für die erhaltenen Bilder.
Dieselbe Anfrage zweimal senden
Fügen Sie einen Header Idempotency-Key mit einem Wert Ihrer Wahl hinzu. Trifft derselbe Schlüssel erneut ein, während die erste Anfrage läuft oder nachdem sie erfolgreich war, antwortet die API mit 409 und erstellt und berechnet nichts erneut. Nach einer fehlgeschlagenen Anfrage können Sie den Schlüssel wiederverwenden.
Schnellstart
Erstellen Sie in drei Schritten Ihr erstes KI-Bild mit der Cheapest Imagen API: Schlüssel erstellen, eine Anfrage senden und das Bild aus der Antwort lesen.
Modelle
Jede Modell-ID der Cheapest Imagen API mit dem offiziellen Modell von OpenAI oder Google, das sie ausführt, den Auflösungen, die sie liefert, und ihren Credits pro Bild.