Zum Inhalt springen
Cheapest Imagen
Anleitungen

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=url

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

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 Anfrage1 bis 16
Größe eines Bildesbis zu 20 MB
Größe der gesamten Anfragebis zu 50 MB
DateitypenPNG, 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:

FeldWas es bewirktWerte
input_fidelityWie genau das Ergebnis die Details der Referenzbilder beibehältlow (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: transparent liefert bei jedem Modell 400.

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-adobe oder eine Version flare oder sunburst. Siehe Seitenverhältnisse und Größen.

Auf dieser Seite