Beeldverhoudingen, resoluties en uitvoerformaten
Op deze pagina
Bijgewerkt op 2 november 2026 — Imagine.
grok-imagine-image-qualityis verwijderd per 2 november 2026 (aanvragen hiervoor worden verwerkt door Imagine 2.0 inlowkwaliteit): 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, terwijl bewerkingen via de xAI SDK of een HTTP-verzoek lopen.
Uw beeldafmetingen onder de knie krijgen
De beeldverhouding en resolutie die u kiest, bepalen direct het uiterlijk en het gebruik van uw gegenereerde afbeeldingen. De Grok Imagine API biedt aanzienlijke flexibiliteit met talrijke vooraf gedefinieerde verhoudingen en twee resolutieniveaus.
Beschikbare beeldverhoudingen
Kies de verhouding op basis van de bestemming, en doe dit voor het genereren. Het achteraf bijsnijden van een vierkante afbeelding tot een panoramische banner snijdt in de compositie die het model voor een vierkant heeft opgebouwd: het onderwerp komt scheef te staan, marges verdwijnen. Direct in het juiste formaat genereren kost evenveel en levert een afbeelding op die voor die verhoudingen is ontworpen.
| Verhouding | Oriëntatie | Typisch gebruik |
|---|---|---|
| 1:1 | Vierkant | Profielen, iconen, Instagram |
| 16:9 | Breed landschap | Presentaties, banners, video |
| 9:16 | Verticaal portret | Stories, Reels, TikTok |
| 4:3 | Klassiek landschap | Traditionele foto's, documenten |
| 3:4 | Portret | Posters, boekomslagen |
| 3:2 / 2:3 | Standaardfoto | Fotoafdrukken, ansichtkaarten |
| 2:1 / 1:2 | Ultra breed / ultra verticaal | Webbanners, panorama's |
| auto | Automatisch | Model kiest optimale verhouding |
Er zijn ook aanvullende verhoudingen beschikbaar voor specifieke gevallen, zoals smartphoneschermen: 9:19.5, 19.5:9, 9:20 en 20:9.
Resoluties: 1k versus 2k
Tussen 1k en 2k is de vraag niet “wat is het beste”, maar “waar wordt deze afbeelding bekeken”. Op een scherm is het verschil voor het overgrote deel van het webgebruik onzichtbaar, en 2k kost alleen extra generatietijd. Het wordt echter cruciaal voor drukwerk, waar het aantal pixels per centimeter direct de waargenomen scherpte bepaalt.
1k: Standaardresolutie, geschikt voor de meeste webtoepassingen. Snellere generatietijd.2k: Hoge resolutie, ideaal voor drukwerk of visuals die veel detail vereisen.
# Standaardresolutie voor web
response_web = client.images.generate(
model="grok-imagine-image",
prompt="Neon-style mobile app icon",
extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)
# Hoge resolutie voor drukwerk
response_print = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Art deco concert poster with elegant typography",
extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)
Uitvoerformaten
De parameter response_format bepaalt hoe de afbeelding aan u wordt teruggegeven:
Tijdelijke URL (Standaard)
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronaut cat",
response_format="url"
)
# response.data[0].url → Tijdelijke URL, snel downloaden
Base64 JSON
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronaut cat",
response_format="b64_json"
)
image_bytes = base64.b64decode(response.data[0].b64_json)
with open("astronaut_cat.png", "wb") as f:
f.write(image_bytes)
Het belangrijke woord is tijdelijk: de geretourneerde URL verloopt. Een applicatie die deze in een database opslaat en weken later weergeeft, zal geconfronteerd worden met gebroken afbeeldingen, vaak lang na de implementatie. Twee opties werken: download de afbeelding direct vanaf de URL, of vraag Base64 direct aan; in beide gevallen moet de afbeelding uiteindelijk op uw eigen opslag terechtkomen.
De juiste combinatie kiezen
Voor elke use-case zijn hier de aanbevolen combinaties:
- Instagram-post:
1:1, resolutie1k, Imagine 1.0 - Story/Reel:
9:16, resolutie1k, Imagine 1.0 - Webbanner:
16:9of2:1, resolutie1k, Imagine 1.0 - Evenementenposter:
3:4, resolutie2k, Imagine 2.0 in kwaliteitmedium - Artikelillustratie:
16:9, resolutie2k, Imagine 2.0 in kwaliteitmedium
Belangrijkste punten
- Meer dan 10 beeldverhoudingen beschikbaar, plus
auto-modus - Twee resoluties:
1k(snel, web) en2k(gedetailleerd, drukwerk) - Twee uitvoerformaten:
url(tijdelijk) enb64_json(persistent) - Geretourneerde MIME-types kunnen PNG, JPEG of WebP zijn
- Pas de verhouding aan op het distributiekanaal van uw afbeelding