Bewerken van meerdere afbeeldingen en referenties
Op deze pagina
Bijgewerkt op 2 november 2026 — Imagine.
grok-imagine-image-qualityis per 2 november 2026 verwijderd (aanvragen worden nu afgehandeld door Imagine 2.0 inlowkwaliteit): voorbeelden gebruiken nugrok-imagine-image(Imagine 1.0) engrok-imagine-image-2.0(Imagine 2.0,low,mediumofautokwaliteit). Met de OpenAI SDK wordenaspect_ratio,resolutionenqualitydoorgegeven viaextra_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
imagesaccepteert tot wel 5 bronafbeeldingen in een array image(enkelvoud) enimages(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