Bilder bearbeiten
Bild zu Bild mit der Cheapest Imagen API. Senden Sie Referenzbilder mit GPT Image oder Nano Banana als Dateien oder Links an /v1/images/edits.
Senden Sie einen Prompt und ein oder mehrere Referenzbilder an POST /v1/images/edits. Jedes Modell nimmt Referenzbilder, und eine Bearbeitung kostet dieselben Credits wie ein neues Bild.
Dateien hochladen
Senden Sie die Anfrage als Formular. Wiederholen Sie image[] für jedes Referenzbild.
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-F model=nano-banana-2.1 \
-F prompt="put the product on a marble table, soft daylight" \
-F "image[]=@product-front.png" \
-F "image[]=@product-side.png" \
-F size=2048x2048 \
-F response_format=urlMit dem OpenAI-SDK:
from openai import OpenAI
client = OpenAI(base_url="https://api.cheapestimagen.com/v1", api_key="YOUR_KEY")
result = client.images.edit(
model="gpt-image-2.6",
image=[open("portrait.png", "rb")],
prompt="change the jacket to dark green, keep the face and the background",
response_format="url",
)
print(result.data[0].url)Links statt Dateien senden
Senden Sie JSON mit einem Array images. Jedes Element hat eine image_url, das ist ein https:-Link oder eine Base64-data:-URL.
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"prompt": "turn this sketch into a watercolour illustration",
"images": [{ "image_url": "https://example.com/sketch.png" }]
}'file_id wird nicht unterstützt; übergeben Sie image_url.
Limits
| Referenzbilder pro Anfrage | 1 bis 16 |
| Größe eines Bildes | bis zu 20 MB |
| Größe der gesamten Anfrage | bis zu 50 MB |
| Dateitypen | PNG, JPEG, WebP |
Eine Anfrage über diesen Limits liefert 413.
Optionen
Jede Option von Text zu Bild funktioniert bei Bearbeitungen: n, size, quality, output_format, response_format. Eine weitere gibt es nur für Bearbeitungen:
| Feld | Was es bewirkt | Werte |
|---|---|---|
input_fidelity | Wie genau das Ergebnis die Details der Referenzbilder beibehält | low (Standard), high. Funktioniert bei GPT Image 2.5 und 2.6 und ihren Versionen flare und sunburst; andere Modelle liefern 400 |
Was nicht unterstützt wird
- Masken. Sie können nicht nur einen Bereich neu malen. Beschreiben Sie im Prompt, was gleich bleiben muss.
- Transparente Hintergründe.
background: transparentliefert bei jedem Modell400.
Tipps
- Senden Sie mehr als einen Blickwinkel des Motivs, wenn es gleich bleiben muss.
- Sagen Sie, was sich nicht ändern darf: „das Etikett unverändert lassen“, „dasselbe Gesicht und dieselbe Frisur“.
- Für Ausgabe in 2K und 4K nutzen Sie Nano Banana,
gpt-image-2-adobeoder eine Version flare oder sunburst. Siehe Seitenverhältnisse und Größen.
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.
Seitenverhältnisse und Größen
Die Bildgrößen, die Sie im Feld size der Cheapest Imagen API übergeben können: bis zu 19 Seitenverhältnisse in 1K, 2K und 4K sowie eigene Größen.