Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Bewerkingen in meerdere stappen en gerichte retouches

Les 8 van 14 Bijgewerkt op 3 november 2026 Beginner
Op deze pagina
  1. Bewerkingen koppelen
  2. Een zone richten via de prompt
  3. Een zone pixel-perfect beschermen: het lokale masker
  4. Volledige bewerkingspijplijn
  5. Belangrijkste punten

Bijgewerkt op 3 november 2026. Gebaseerd op de pagina Image Editing, de Image Prompting Guide en de xAI Images API-referentie: het /v1/images/edits-endpoint heeft geen mask-parameter—noch in de referentie, noch in xai-sdk 1.21.0—in tegenstelling tot wat de vorige versie beweerde. Retouches worden gericht via de prompt, en een zone wordt pixel-perfect beschermd door een lokaal toegepast masker na de bewerking. Bronnen: Image Editing · Image Prompting Guide · Images API.

Bewerkingen koppelen

Afbeeldingsbewerking wordt pas echt krachtig wanneer u meerdere wijzigingen aan elkaar koppelt. Het principe, zoals beschreven door xAI, is eenvoudig: de uitvoer van de ene bewerking wordt de invoer van de volgende, zodat u kunt beginnen met een basisafbeelding en vervolgens stap voor stap details kunt toevoegen, de stijl kunt aanpassen of correcties kunt uitvoeren.

import requests
import os

headers = {
    "Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
    "Content-Type": "application/json"
}

def edit_image(image_url, prompt):
    """Edits an image and returns the result URL."""
    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"]

# Turn 1: modify the background
url_tour1 = edit_image(
    "https://exemple.com/portrait.jpg",
    "Replace the background with a modern office overlooking the city. "
    "Keep the same person, pose, and framing."
)

# Turn 2: adjust the lighting
url_tour2 = edit_image(
    url_tour1,
    "Make the light warm and dim, like late afternoon. "
    "Keep the same person, decor, and framing."
)

# Turn 3: add an element
url_tour3 = edit_image(
    url_tour2,
    "Place an open laptop on the desk, in front of the person. "
    "Keep the same person, lighting, and framing."
)

print(f"Final result: {url_tour3}")

Best practices voor bewerkingen in meerdere stappen

De xAI-gids adviseert om te bewerken wanneer het onderwerp en de lay-out al goed zijn en slechts één tot drie details gewijzigd hoeven te worden; als het onderwerp zelf fout is, kunt u beter opnieuw genereren. Elke stap begint met de wijziging en vermeldt vervolgens in één zin wat niet verandert: het onderwerp, de hoek, de uitsnede of de plaatsing van objecten. Volgens de gids leiden twee formuleringen tot mislukkingen: een die begint met “houd alles hetzelfde”, waardoor er bijna niets verandert, en een die een volledige prompt kopieert, waardoor de scène opnieuw wordt opgebouwd—het onderwerp verschuift, een object verdubbelt of verandert in een naburig object.

Orden de stappen van algemeen naar specifiek: eerst achtergrond, compositie en sfeer, daarna accessoires en fijne correcties, zodat een late grote wijziging de kleine retouches niet ongedaan maakt.

Twee veiligheidsmaatregelen vervolledigen de methode. Download elk tussenresultaat zodra het is gegenereerd: URL’s zijn tijdelijk, en het verliezen van stap 3 in een reeks van vijf dwingt u om opnieuw te beginnen vanaf stap 2. Inspecteer bovendien elke stap voordat u verdergaat: een fout die in stap 1 wordt geïntroduceerd—een vervormde vinger, een inconsistente schaduw—komt terug in alle daaropvolgende stappen, aangezien elke stap begint met de vorige afbeelding.

Een zone richten via de prompt

De API accepteert geen masker: de prompt richt de bewerking. Benadruk het te wijzigen deel zo nauwkeurig mogelijk—op naam, positie, materiaal—en benoem wat identiek moet blijven.

url_chapeau = edit_image(
    url_tour3,
    "Replace the person's cap with a wide-brimmed straw hat. "
    "Keep the same face, hairstyle, decor, and framing."
)

Wanneer een correctie niet aanslaat, raadt de gids aan om de bewoordingen te wijzigen in plaats van hetzelfde verzoek te herhalen; wijs daarbij het te corrigeren deel van de afbeelding aan en beschrijf wat er moet verschijnen. Om meerdere afbeeldingen samen te voegen—een product in een decor, een personage van de ene afbeelding naar de andere—accepteert de bewerkingsfunctie tot vijf bronafbeeldingen (les 7).

Een zone pixel-perfect beschermen: het lokale masker

Als een deel van de afbeelding geen pixel mag bewegen—een logo, een gezicht, tekst—pas dan het masker lokaal toe, na de bewerking: u behoudt de originele zone en neemt van de bewerkte versie alleen wat buiten deze zone valt. Met Pillow kopieert Image.composite(image1, image2, mask) image1 waar het masker wit is en behoudt image2 waar het zwart is:

from PIL import Image, ImageDraw

original = Image.open("original.jpg").convert("RGB")
edite = Image.open("edite.jpg").convert("RGB").resize(original.size)

# Mask: white = take edit, black = keep original
masque = Image.new("L", original.size, 255)
draw = ImageDraw.Draw(masque)
draw.rectangle([40, 40, 360, 160], fill=0)  # protected zone, e.g., a logo

resultat = Image.composite(edite, original, masque)
resultat.save("resultat.jpg")

De drie afbeeldingen moeten dezelfde afmetingen hebben. Het wijzigen van het formaat gaat ervan uit dat de bewerking de beeldverhouding van de bron heeft behouden: controleer dit, of forceer het met de parameter aspect_ratio in het verzoek. Het masker verhindert niet dat het model de zone aanraakt; het stelt u in staat deze afterward te herstellen.

Volledige bewerkingspijplijn

Hier is een voorbeeld van een gestructureerde pijplijn, waarbij de geschiedenis van elke stap wordt bijgehouden:

class ImageEditor:
    def __init__(self, api_key):
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }
        self.history = []

    def edit(self, image_url, prompt):
        response = requests.post(
            "https://api.x.ai/v1/images/edits",
            headers=self.headers,
            json={
                "model": "grok-imagine-image",
                "prompt": prompt,
                "image": {"url": image_url}
            }
        )
        response.raise_for_status()

        result_url = response.json()["data"][0]["url"]
        self.history.append({
            "prompt": prompt,
            "input": image_url,
            "output": result_url
        })
        return result_url

Belangrijkste punten

  • Bewerkingen in meerdere stappen koppelen resultaten: elke uitvoer wordt de invoer van de volgende bewerking
  • Bewerk wanneer het onderwerp en de lay-out goed zijn en slechts één tot drie details gewijzigd hoeven te worden
  • Elke stap: eerst de wijziging, daarna wat identiek moet blijven
  • De API heeft geen mask-parameter: richt via de prompt en bescherm een zone met een lokaal masker dat na de bewerking wordt toegepast
  • Uitvoer-URL’s zijn tijdelijk: download tussenresultaten