Mehrstufiges Bearbeiten und gezieltes Retuschieren
Auf dieser Seite
Aktualisiert am 3. November 2026. Basierend auf der Seite Bildbearbeitung, dem Bild-Prompting-Leitfaden und der Referenz für die xAI Images API: Der Endpunkt
/v1/images/editsverfügt über keinen Parametermask– weder in der Referenz noch in derxai-sdk1.21.0 – im Gegensatz zu früheren Versionen. Das Retuschieren erfolgt über den Prompt gerichtet, und ein Bereich wird pixelgenau durch eine lokal angewandte Maske geschützt, nachdem die Bearbeitung abgeschlossen ist. Quellen: Bildbearbeitung · Bild-Prompting-Leitfaden · Images API.
Verkettung von Bearbeitungen
Bildbearbeitung entfaltet ihre wahre Kraft, wenn mehrere Modifikationen verkettet werden. Das Prinzip, das von xAI beschrieben wird, ist einfach: Die Ausgabe einer Bearbeitung wird zur Eingabe der nächsten, sodass Sie von einem Basisbild ausgehen können, um Details hinzuzufügen, den Stil anzupassen oder Fehler korrigieren, Schritt für Schritt.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
def edit_image(image_url, prompt):
"""Bearbeitet ein Bild und gibt die Ergebnis-URL zurück."""
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json={
"model": "grok-imagine-image",
"prompt": prompt,
"image": {"url": image_url}
}
)
response.raise_for_status()
return response.json()["data"][0]["url"]
# Runde 1: Hintergrund ändern
url_runde1 = edit_image(
"https://exemple.com/portrait.jpg",
"Ersetzen Sie den Hintergrund durch ein modernes Büro mit Blick auf die Stadt. "
"Behalten Sie dieselbe Person, Pose und Bildkomposition bei."
)
# Runde 2: Beleuchtung anpassen
url_runde2 = edit_image(
url_runde1,
"Machen Sie das Licht warm und gedimmt, wie am späten Nachmittag. "
"Behalten Sie dieselbe Person, Einrichtung und Bildkomposition bei."
)
# Runde 3: Element hinzufügen
url_runde3 = edit_image(
url_runde2,
"Platzieren Sie einen geöffneten Laptop auf dem Schreibtisch, vor der Person. "
"Behalten Sie dieselbe Person, Beleuchtung und Bildkomposition bei."
)
print(f"Endergebnis: {url_runde3}")
Best Practices für mehrstufiges Bearbeiten
Der xAI-Leitfaden empfiehlt, zu bearbeiten, wenn das Motiv und die Komposition bereits gut sind und nur ein bis drei Details geändert werden müssen; wenn das Motiv selbst falsch ist, ist es besser, neu zu generieren. Jede Runde beginnt mit der Modifikation, gefolgt von einem Satz, der angibt, was unverändert bleibt: das Motiv, der Winkel, die Bildkomposition und die Objektplatzierung. Zwei Formulierungen scheitern laut Leitfaden: eine, die mit „alles beibehalten” beginnt, was fast nichts ändert, und eine, die einen vollständigen Prompt kopiert, was die Szene neu zusammensetzt – das Motiv wandert ab, ein Objekt verdoppelt sich oder verwandelt sich in ein benachbartes Objekt.
Ordnen Sie die Runden vom Allgemeinen zum Speziellen an: zuerst Hintergrund, Komposition und Atmosphäre, dann Accessoires und Feinkorrekturen, damit eine späte große Änderung die kleinen Retuschen nicht zunichtemacht.
Zwei Sicherheitsvorkehrungen vervollständigen das Verfahren. Laden Sie jedes Zwischenergebnis sofort herunter, sobald es erzeugt wird: Die URLs sind temporär, und der Verlust der dritten Runde einer Serie aus fünf zwingt Sie, von Runde 2 neu zu beginnen. Und prüfen Sie jeden Schritt vor der Verkettung: Ein Fehler, der in Runde 1 eingeführt wird – ein verzerrter Finger, eine inkonsistente Schattenwurf – findet sich in allen nachfolgenden Runden wieder, da jede Runde vom vorherigen Bild ausgeht.
Zielsetzung eines Bereichs über den Prompt
Die API akzeptiert keine Maske: Der Prompt richtet sich aus. Bezeichnen Sie den zu ändernden Teil so präzise wie möglich – nach Name, Position, Material – und nennen Sie, was identisch bleiben muss.
url_hut = edit_image(
url_runde3,
"Ersetzen Sie den Hut der Person durch einen breitkrempigen Strohhut. "
"Behalten Sie dasselbe Gesicht, die Frisur, die Einrichtung und die Bildkomposition bei."
)
Wenn eine Korrektur nicht greift, empfiehlt der Leitfaden, die Wörter zu ändern, anstatt dieselbe Anfrage zu wiederholen, indem Sie den Teil des Bildes benennen, der korrigiert werden soll, und was er zeigen sollte. Um mehrere Bilder zusammenzufügen – ein Produkt in einer Einrichtung, ein Charakter von einem Bild zum anderen – akzeptiert die Bearbeitung bis zu fünf Quellbilder (Lektion 7).
Pixelgenauer Schutz eines Bereichs: Die lokale Maske
Wenn ein Teil des Bildes nicht ein einziges Pixel bewegen darf – ein Logo, ein Gesicht, Text – wenden Sie die Maske lokal an, nach der Bearbeitung: Sie behalten den ursprünglichen Bereich und entnehmen der Bearbeitung nur das, was außerhalb dieses Bereichs liegt. Mit Pillow kopiert Image.composite(image1, image2, mask) image1, wo die Maske weiß ist, und behält image2, wo sie schwarz ist:
from PIL import Image, ImageDraw
original = Image.open("original.jpg").convert("RGB")
edite = Image.open("edite.jpg").convert("RGB").resize(original.size)
# Maske: Weiß = Bearbeitung übernehmen, Schwarz = Original behalten
maske = Image.new("L", original.size, 255)
zeichne = ImageDraw.Draw(maske)
zeichne.rechteck([40, 40, 360, 160], ausfüllung=0) # geschützter Bereich, z. B. ein Logo
ergebnis = Image.composite(edite, original, maske)
ergebnis.speichern("ergebnis.jpg")
Die drei Bilder müssen dieselbe Größe haben. Das Skalieren geht davon aus, dass die Bearbeitung das Seitenverhältnis der Quelle beibehalten hat: Überprüfen Sie dies oder erzwingen Sie es mit dem Parameter aspect_ratio der Anfrage. Die Maske verhindert nicht, dass das Modell den Bereich berührt; sie ermöglicht es Ihnen, ihn danach wiederherzustellen.
Vollständiger Bearbeitungs-Pipeline
Hier ist ein Beispiel für eine strukturierte Pipeline, die die Historie jeder Runde bewahrt:
class BildEditor:
def __init__(self, api_key):
self.headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
self.historie = []
def bearbeiten(self, bild_url, prompt):
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=self.headers,
json={
"model": "grok-imagine-image",
"prompt": prompt,
"image": {"url": bild_url}
}
)
response.raise_for_status()
ergebnis_url = response.json()["data"][0]["url"]
self.historie.append({
"prompt": prompt,
"input": bild_url,
"output": ergebnis_url
})
return ergebnis_url
Kernaussagen
- Mehrstufiges Bearbeiten verkettet Ergebnisse: Jede Ausgabe wird zur Eingabe der nächsten Bearbeitung
- Bearbeiten Sie, wenn das Motiv und die Komposition gut sind und nur ein bis drei Details geändert werden müssen
- Jede Runde: Zuerst die Modifikation, dann das, was unverändert bleiben muss
- Die API verfügt über keinen
mask-Parameter: Richten Sie sich über den Prompt aus und schützen Sie einen Bereich mit einer lokal angewandten Maske nach der Bearbeitung - Ausgabe-URLs sind temporär: Laden Sie Zwischenergebnisse herunter