Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Beeldverhoudingen, resoluties en uitvoerformaten

Les 3 van 14 Bijgewerkt op 2 november 2026 Beginner
Op deze pagina
  1. Uw beeldafmetingen onder de knie krijgen
  2. Beschikbare beeldverhoudingen
  3. Resoluties: 1k versus 2k
  4. Uitvoerformaten
  5. De juiste combinatie kiezen
  6. Belangrijkste punten

Bijgewerkt op 2 november 2026 — Imagine. grok-imagine-image-quality is verwijderd per 2 november 2026 (aanvragen hiervoor worden verwerkt door Imagine 2.0 in 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, 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, resolutie 1k, Imagine 1.0
  • Story/Reel: 9:16, resolutie 1k, Imagine 1.0
  • Webbanner: 16:9 of 2:1, resolutie 1k, Imagine 1.0
  • Evenementenposter: 3:4, resolutie 2k, Imagine 2.0 in kwaliteit medium
  • Artikelillustratie: 16:9, resolutie 2k, Imagine 2.0 in kwaliteit medium

Belangrijkste punten

  • Meer dan 10 beeldverhoudingen beschikbaar, plus auto-modus
  • Twee resoluties: 1k (snel, web) en 2k (gedetailleerd, drukwerk)
  • Twee uitvoerformaten: url (tijdelijk) en b64_json (persistent)
  • Geretourneerde MIME-types kunnen PNG, JPEG of WebP zijn
  • Pas de verhouding aan op het distributiekanaal van uw afbeelding