Kwaliteitsparameter en renderoptimalisatie
Op deze pagina
Les herschreven op 2 november 2026. De vorige versie beschreef een
high-waarde en eenquality-parameter die geen invloed hadden op de prijs, voor een “pro”-model dat inmiddels is stopgezet. Volgens de huidige xAI-documentatie isqualityspecifiek voor Imagine 2.0, accepteert hetlow,mediumenauto, en wordt elke afbeelding gefactureerd op basis van de kwaliteit waarmee deze wordt geleverd.
Generatiekwaliteit sturen

In de Grok-app balanceert de keuze Snelheid / Kwaliteit tussen snelheid en finesse. In de API hangt deze balans af van twee keuzes: het model (Imagine 1.0 of Imagine 2.0) en, voor Imagine 2.0, de parameter quality.
De parameter quality
quality wordt geaccepteerd door grok-imagine-image-2.0, zowel voor generatie als voor bewerking. Er zijn drie waarden:
low: de goedkoopste instelling voor Imagine 2.0 ($0,04 per afbeelding tegen de gepubliceerde tarieven); hierheen worden verzoeken van het oude “pro”-model doorgestuurd;medium: meer rekenkracht per afbeelding voor fijnere details; reserveer dit voor afbeeldingen waarbij kwaliteit belangrijker is dan kosten;auto: de standaardwaarde wanneer de parameter wordt weggelaten; momenteel levert ditlowop bij generatie enmediumbij bewerking, en wordt de afbeelding gefactureerd op de geleverde kwaliteit.
Stel de kwaliteit expliciet in om zowel de render als de factuur te beheersen, in plaats van auto de keuze te laten. Met de OpenAI SDK die naar de xAI-API wijst, geeft u dit door via extra_body:
# Snel concept: Imagine 1.0, het goedkoopst
brouillon = client.images.generate(
model="grok-imagine-image",
prompt="E-commerce website mockup, wireframe style",
)
# Standaardvisual: Imagine 2.0, lage kwaliteit
courant = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Illustration of a mobile fitness app",
extra_body={"quality": "low"},
)
# Definitieve visual: Imagine 2.0, medium kwaliteit, 2k-resolutie
final = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Advertising poster for a luxury perfume, photorealistic render",
extra_body={"quality": "medium", "resolution": "2k"},
)
Combinatie van model + kwaliteit + resolutie
Drie parameters, drie effecten: het model bepaalt de basisprijs en beschikbare functies, quality het detailniveau voor Imagine 2.0 (en het bijbehorende tarief), en resolution de afbeeldingsdefinitie (standaard 1k, of 2k).
| Use case | Model | Kwaliteit | Resolutie |
|---|---|---|---|
| Snel prototype | Imagine 1.0 | — | 1k |
| Webcontent | Imagine 1.0 | — | 1k |
| Social media | Imagine 2.0 | low | 1k |
| Marketingvisual | Imagine 2.0 | medium | 1k |
| Drukwerk, poster | Imagine 2.0 | medium | 2k |
Optimalisatiewerkflow in 3 stappen
Vind het juiste idee waar het goedkoop is, verfijn het, en betaal alleen voor de duurste render op de geselecteerde afbeelding.
Stap 1: Verkennen
prompts_candidats = [
"A robot barista making coffee, cartoon style",
"A robotic arm pouring coffee, realistic style",
"A mechanical hand holding a steaming cup, steampunk style",
]
for prompt in prompts_candidats:
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=3,
)
# Kosten: 3 x $0,02 = $0,06 per prompt
Stap 2: Verfijnen
best_prompt = "A robotic arm pouring coffee, realistic style"
response = client.images.generate(
model="grok-imagine-image-2.0",
prompt=best_prompt,
n=4,
extra_body={"quality": "low", "resolution": "1k"},
)
# Kosten: 4 x $0,04 = $0,16
Stap 3: Afronden
response = client.images.generate(
model="grok-imagine-image-2.0",
prompt=best_prompt + ", cinematic lighting, fine mechanical details",
n=2,
extra_body={"quality": "medium", "resolution": "2k"},
)
# Kosten: 2 afbeeldingen tegen het huidige "medium"-tarief
De eerste twee stappen kosten $0,34 voor negen concepten en vier varianten; alleen de twee definitieve afbeeldingen worden tegen het medium-tarief gefactureerd.
Kwaliteitsselectie automatiseren
Centraliseer deze keuze in een functie om versnippering in uw code te voorkomen. Als tarieven wijzigen of er een model bijkomt, hoeft u slechts één plek aan te passen.
CONFIGS = {
"prototype": {"model": "grok-imagine-image", "extra_body": {"resolution": "1k"}},
"web": {"model": "grok-imagine-image", "extra_body": {"resolution": "1k"}},
"social": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "low", "resolution": "1k"}},
"marketing": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "medium", "resolution": "1k"}},
"print": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "medium", "resolution": "2k"}},
}
def generate_smart(prompt, usage="web"):
"""Genereer een afbeelding met parameters die passen bij de use case."""
config = CONFIGS.get(usage, CONFIGS["web"])
return client.images.generate(prompt=prompt, **config)
Officiële bronnen: Image Generation — Quality · grok-imagine-image-quality Retirement on November 2, 2026 · Pricing
Belangrijkste punten
qualityis specifiek voor Imagine 2.0 en accepteertlow,mediumenauto(standaardwaarde)- De afbeelding wordt gefactureerd op de geleverde kwaliteit: stel de kwaliteit expliciet in om de factuur te beheersen
- Met de OpenAI SDK gaan
qualityenresolutionviaextra_body - Werkflow in 3 stappen: verken met Imagine 1.0, verfijn in
low, rond af inmedium - Centraliseer parameterselectie in een configuratiefunctie