Bildbearbeitung und Referenzbilder

Gib einem Bildmodell Bilder als Vorlage: Bearbeite ein Foto, platziere ein Produkt in einer neuen Szene, halte eine Figur über mehrere Aufnahmen hinweg konsistent oder kombiniere mehrere Bilder zu einem.

Zwei Wege, Bilder zu senden

Beide unterstützen dieselben Modelle, Größen und Preise wie die Generierung. Eine Bearbeitung kostet genauso viel wie ein neues Bild dieser Größe.

Wie viele Bilder jedes Modell annimmt

Mit OpenAIs SDKs

import os
from openai import OpenAI
client = OpenAI(base_url="https://api.zurelay.com/v1", api_key=os.environ["ZURELAY_API_KEY"])
result = client.images.edit(
    model="gpt-image-2",
    image=[open("product.png", "rb"), open("background.jpg", "rb")],
    prompt="Put the bottle from the first image on the marble counter in the second. Keep its label exactly.",
)
print(result.data[0].url)

Als JSON

Liste bei beiden Endpoints die Bilder in images als Links oder Daten-URLs auf (für ein einzelnes Bild funktioniert auch image):

import os
import requests
response = requests.post(
    "https://api.zurelay.com/v1/images/generations",
    headers={"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"},
    json={
      "model": "nano-banana-pro",
      "prompt": "Make the jacket in the first image deep green, and give the model the pose from the second.",
      "images": [
        "https://example.com/model.jpg",
        "data:image/png;base64,iVBORw0KGgo..."
      ],
      "size": "2K",
      "aspect_ratio": "4:5"
    },
)
response.raise_for_status()
print(response.json())

Regeln für Eingabebilder

• PNG, JPEG oder WebP, jeweils bis zu 20 MB.
• Links müssen öffentliche https-URLs sein; wir laden die Bilder selbst herunter. Lässt sich ein Bild nicht herunterladen, wird die Anfrage mit invalid_image abgelehnt, bevor etwas erstellt wird.
• Beziehe dich im Prompt auf die Reihenfolge der Bilder: „das erste Bild“, „das zweite Bild“.
• Masken werden nicht unterstützt. Beschreibe stattdessen die Änderung („ersetze nur den Himmel“); diese Modelle bearbeiten nur das, was du nennst.
• Überschreitest du das Limit eines Modells, wird die Anfrage mit einer klaren Fehlermeldung abgelehnt, die das Limit nennt.

Was du ausprobieren kannst