Endpoint /v1/images/edits: uw afbeeldingen bewerken
Op deze pagina
Bijgewerkt op 2 november 2026 — Imagine.
grok-imagine-image-qualityis op 2 november 2026 verwijderd (aanvragen hiervoor worden verwerkt door Imagine 2.0 metlowkwaliteit): voorbeelden gebruiken nugrok-imagine-image(Imagine 1.0) engrok-imagine-image-2.0(Imagine 2.0, met kwaliteitlow,mediumofauto). Met de OpenAI SDK gaanaspect_ratio,resolutionenqualityviaextra_body, en bewerkingen vereisen de xAI SDK of een HTTP-verzoek.
Afbeeldingen bewerken met de Grok API
Naast het genereren van afbeeldingen biedt de xAI API een specifiek endpoint voor het bewerken van bestaande afbeeldingen: POST /v1/images/edits. Met dit endpoint kunt u afbeeldingen wijzigen, transformeren of verbeteren door de gewenste aanpassingen te beschrijven in een eenvoudige tekstprompt.
Structuur van een bewerkingsverzoek
Bewerken werkt vergelijkbaar met genereren, maar met één cruciaal verschil dat uw manier van prompten volledig verandert: de prompt beschrijft de wijziging, niet het eindresultaat. “Een vrouw met een zonnebril” genereert een volledig nieuwe afbeelding; “voeg een zonnebril toe” behoudt de foto en grijpt alleen in op dat specifieke punt. Dit is de meest voorkomende verwarring bij de eerste poging en verklaart de meeste teleurstellende resultaten.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Voeg een rode hoed toe aan het personage",
"image": {
"url": "https://exemple.com/photo-personnage.jpg"
}
}
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
result = response.json()
edited_url = result["data"][0]["url"]
Waarom requests gebruiken in plaats van de OpenAI SDK?
Dit is de technische valkuil van deze les, en u wilt dit weten voordat u er een uur aan verspilt: de compatibiliteit met de OpenAI SDK, die perfect werkt voor generatie, stopt bij bewerkingen. Het xAI-bewerkingsendpoint gebruikt een JSON-indeling, terwijl de images.edit()-methode van de SDK multipart/form-data verzendt. Deze incompatibiliteit van content-type betekent dat u voor bewerkingen rechtstreeks de REST API moet gebruiken met de requests-bibliotheek.
# WERKT NIET met de xAI API
# client.images.edit(...) # Verzendt multipart, geen JSON
# WERKT: directe REST-aanroep
requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
Parameters van het bewerkingsendpoint
model(verplicht):grok-imagine-image(Imagine 1.0) ofgrok-imagine-image-2.0(Imagine 2.0, accepteert ookquality)prompt(verplicht): beschrijving van de toe te passen wijzigingimage: object met de URL van één bronafbeeldingimages: array van objecten voor meerdere bronafbeeldingen (sluitimageuit)mask: object met de URL van het maskergebied dat bewerkt moet wordenn: aantal te genereren varianten (1 tot 10)response_format:urlofb64_json
Soorten mogelijke bewerkingen
De vijf onderstaande categorieën hebben niet allemaal hetzelfde slagingspercentage; het helpt om dit te weten voordat u een resultaat belooft. Elementen toevoegen en de sfeer wijzigen werken zeer goed omdat ze voortbouwen op bestaande inhoud. Verwijderen is lastiger: het model moet reconstrueren wat er achter het verwijderde element zat. Dit is waar het maskeren essentieel wordt, door het gebied dat opnieuw berekend moet worden nauwkeurig af te bakenen.
- Elementen toevoegen: “Voeg een zonnebril toe aan het personage”
- Verwijderen: “Verwijder de achtergrond en vervang deze door een witte achtergrond”
- Stijltransformatie: “Zet deze foto om in een aquarelillustratie”
- Sfeerwijziging: “Verander de scène van dag naar nacht”
- Correctie: “Verbeter de belichting en verhoog het contrast”
# Voorbeeld: de stijl van een afbeelding wijzigen
payload = {
"model": "grok-imagine-image",
"prompt": "Transformeer deze foto naar een illustratie in Franco-Belgische stripstijl",
"image": {
"url": "https://exemple.com/photo-ville.jpg"
}
}
Praktijkoefening
Probeer een afbeelding in meerdere stappen te bewerken. Begin met een eenvoudige wijziging en verfijn deze vervolgens:
# Stap 1: de achtergrond wijzigen
payload_step1 = {
"model": "grok-imagine-image",
"prompt": "Vervang de achtergrond door een zonsondergang boven de oceaan",
"image": {"url": "https://exemple.com/portrait.jpg"}
}
Belangrijkste punten
- Het bewerkingsendpoint is
POST /v1/images/edits - Gebruik in Python
requests, niet de OpenAI SDK (incompatibele indeling) - U kunt maximaal 5 bronafbeeldingen per verzoek opgeven
- De prompt beschrijft de gewenste wijziging in natuurlijke taal
- Beide modellen (Imagine 1.0 en Imagine 2.0) zijn beschikbaar voor bewerkingen; met de OpenAI SDK wordt
images.edit()niet ondersteund door xAI: gebruik de xAI SDK of een HTTP-verzoek