Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Endpoint /v1/images/edits: uw afbeeldingen bewerken

Les 5 van 14 Bijgewerkt op 2 november 2026 Beginner
Op deze pagina
  1. Afbeeldingen bewerken met de Grok API
  2. Structuur van een bewerkingsverzoek
  3. Waarom requests gebruiken in plaats van de OpenAI SDK?
  4. Parameters van het bewerkingsendpoint
  5. Soorten mogelijke bewerkingen
  6. Praktijkoefening
  7. Belangrijkste punten

Bijgewerkt op 2 november 2026 — Imagine. grok-imagine-image-quality is op 2 november 2026 verwijderd (aanvragen hiervoor worden verwerkt door Imagine 2.0 met low kwaliteit): voorbeelden gebruiken nu grok-imagine-image (Imagine 1.0) en grok-imagine-image-2.0 (Imagine 2.0, met kwaliteit low, medium of auto). Met de OpenAI SDK gaan aspect_ratio, resolution en quality via extra_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.

5
Maximaal aantal bronafbeeldingen
2
Invoerformaten
JSON
Vereiste Content-Type
∞
Bewerkingsrondes

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) of grok-imagine-image-2.0 (Imagine 2.0, accepteert ook quality)
  • prompt (verplicht): beschrijving van de toe te passen wijziging
  • image: object met de URL van één bronafbeelding
  • images: array van objecten voor meerdere bronafbeeldingen (sluit image uit)
  • mask: object met de URL van het maskergebied dat bewerkt moet worden
  • n: aantal te genereren varianten (1 tot 10)
  • response_format: url of b64_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