Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Bewerken van meerdere afbeeldingen en referenties

Les 7 van 14 Bijgewerkt op 2 november 2026 Beginner
Op deze pagina
  1. Werken met meerdere bronafbeeldingen
  2. De parameter images (meervoud)
  3. Afbeeldingen refereren in de prompt
  4. Use-cases met meerdere afbeeldingen
  5. Limieten en best practices
  6. Oefening in de praktijk
  7. Belangrijkste punten

Bijgewerkt op 2 november 2026 — Imagine. grok-imagine-image-quality is per 2 november 2026 verwijderd (aanvragen worden nu afgehandeld door Imagine 2.0 in low kwaliteit): voorbeelden gebruiken nu grok-imagine-image (Imagine 1.0) en grok-imagine-image-2.0 (Imagine 2.0, low, medium of auto kwaliteit). Met de OpenAI SDK worden aspect_ratio, resolution en quality doorgegeven via extra_body, en wordt bewerking afgehandeld via de xAI SDK of een HTTP-verzoek.

Werken met meerdere bronafbeeldingen

Een van de sterke punten van het bewerkingsendpoint is de mogelijkheid om tot wel 5 referentieafbeeldingen in één verzoek op te geven. Dit opent geavanceerde creatieve mogelijkheden: elementen uit meerdere bronnen combineren, stijlen mengen of complexe composities creëren.

De parameter images (meervoud)

Overschakelen van image naar images verandert meer dan alleen de vorm van de parameter: het verandert wat u het model vraagt te doen. Met één bron wijzigt het een afbeelding; met meerdere moet het bemiddelen tussen hen—beslissen wat het van elk overneemt. Het zal hoe dan ook bemiddelen; de enige vraag is of u dat proces stuurt, wat het onderwerp is van de volgende sectie.

Merk op dat de twee parameters elkaar uitsluiten: image (enkel object) en images (array) kunnen niet worden gecombineerd.

import requests
import os

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

payload = {
    "model": "grok-imagine-image",
    "prompt": "Combineer het personage uit de eerste afbeelding met "
              "het landschap uit de tweede afbeelding",
    "images": [
        {"url": "https://exemple.com/personnage.jpg"},
        {"url": "https://exemple.com/paysage.jpg"}
    ]
}

response = requests.post(
    "https://api.x.ai/v1/images/edits",
    headers=headers,
    json=payload
).json()

Afbeeldingen refereren in de prompt

Wanneer u meerdere afbeeldingen opgeeft, kunt u ze individueel refereren in uw prompt met de syntaxis <IMAGE_0>, <IMAGE_1>, enzovoort. De index begint bij 0.

payload = {
    "model": "grok-imagine-image",
    "prompt": "Plaats het product van <IMAGE_0> op de tafel van <IMAGE_1>, "
              "met de omgevingsverlichting van <IMAGE_2>",
    "images": [
        {"url": "https://exemple.com/produit.jpg"},      # <IMAGE_0>
        {"url": "https://exemple.com/table.jpg"},         # <IMAGE_1>
        {"url": "https://exemple.com/ambiance.jpg"}       # <IMAGE_2>
    ]
}

Deze syntaxis onderscheidt een gecontroleerde compositie van een benaderende mengeling. “Combineer deze afbeeldingen” laat alles aan het model over; “plaats het product van <IMAGE_0> in de setting van <IMAGE_1> terwijl de verlichting van <IMAGE_1> behouden blijft” laat geen ruimte voor interpretatie. Zodra u meer dan één bron opgeeft, refereert u er expliciet naar.

Use-cases met meerdere afbeeldingen

Stijloverdracht

Pas de stijl van een referentieafbeelding toe op een andere:

payload = {
    "model": "grok-imagine-image-2.0",
    "prompt": "Reproduceer de inhoud van <IMAGE_0> in de artistieke stijl van <IMAGE_1>",
    "images": [
        {"url": "https://exemple.com/photo-originale.jpg"},
        {"url": "https://exemple.com/reference-style.jpg"}
    ]
}

Productcompositie

Integreer een product in een setting met referentieverlichting:

payload = {
    "model": "grok-imagine-image-2.0",
    "prompt": "Fotografeer het product van <IMAGE_0> geplaatst op het meubel van <IMAGE_1> "
              "in de kamer van <IMAGE_2>, met consistente natuurlijke verlichting",
    "images": [
        {"url": "https://exemple.com/produit-detouré.png"},
        {"url": "https://exemple.com/meuble.jpg"},
        {"url": "https://exemple.com/piece.jpg"}
    ]
}

Gezichts- en achtergrondfusie

Combineer een portret met een specifieke achtergrond:

payload = {
    "model": "grok-imagine-image",
    "prompt": "Plaats de persoon van <IMAGE_0> voor het gebouw van <IMAGE_1>, "
              "met behoud van natuurlijke verlichting en perspectief",
    "images": [
        {"url": "https://exemple.com/portrait.jpg"},
        {"url": "https://exemple.com/batiment.jpg"}
    ]
}

Limieten en best practices

De technische limiet is 5 afbeeldingen per verzoek, en u kunt formaten vrijelijk mixen—sommige bronnen als URL’s, andere als Base64—in dezelfde array. De echte moeilijkheid ligt daar niet: die zit in de precisie van de prompt, die moet groeien met het aantal afbeeldingen. Met twee bronnen volstaat “combineer het personage en de setting” vaak; met vijf kan het model niet langer raden welk element uit welke afbeelding moet komen, en dit is precies de rol van de referenties <IMAGE_1> tot <IMAGE_5>: “plaats het logo van <IMAGE_2> op het t-shirt van het personage van <IMAGE_1>, in de verlichtingssfeer van <IMAGE_3>” laat geen ambiguïteit toe. Voor complexe composities met meerdere bronnen rechtvaardigt het pro-model (grok-imagine-image-quality) de extra kosten: dit is precies waar het verschil met het standaardmodel het meest zichtbaar is, in de consistentie tussen heterogene elementen.

Oefening in de praktijk

Probeer twee afbeeldingen die u bij de hand heeft te combineren:

payload = {
    "model": "grok-imagine-image",
    "prompt": "Creëer een scène waarin het object van <IMAGE_0> zweeft in de lucht van <IMAGE_1>, "
              "in surrealistische stijl",
    "images": [
        {"url": "URL_OF_YOUR_FIRST_IMAGE"},
        {"url": "URL_OF_YOUR_SECOND_IMAGE"}
    ],
    "n": 3
}

Genereer 3 variaties om de interpretaties van het model te vergelijken.

Belangrijkste punten

  • De parameter images accepteert tot wel 5 bronafbeeldingen in een array
  • image (enkelvoud) en images (meervoud) sluiten elkaar wederzijds uit
  • De syntaxis <IMAGE_0>, <IMAGE_1> stelt u in staat elke afbeelding in de prompt te refereren
  • Use-cases omvatten stijloverdracht, compositie en fusie
  • Wees precies in uw prompt bij gebruik van meerdere bronnen