Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Endpoint /v1/images/generations: aan de slag

Les 1 van 14 Bijgewerkt op 3 november 2026 Beginner
Op deze pagina
  1. Genereer uw eerste afbeelding met de Grok API
  2. Structuur van een generatieverzoek
  3. Verzoekparameters
  4. Responsformaat
  5. Praktijkoefening
  6. Belangrijkste punten

Les voltooid op 3 november 2026 op basis van de pagina Image Generation en de xAI Images API-referentie: standaardwaarden (aspect_ratio ingesteld op auto, resolution op 1k), de parameter quality voor Imagine 2.0, en JPEG als standaardformaat. Bronnen: Image Generation · Images API.

Genereer uw eerste afbeelding met de Grok API

Afbeelding gegenereerd door Grok De xAI API biedt een specifiek endpoint voor afbeeldingsgeneratie: POST /v1/images/generations. Met dit endpoint maakt u afbeeldingen op basis van een tekstbeschrijving met behulp van Grok Imagine-modellen. Of u nu illustraties, marketingmateriaal of creatieve prototypes wilt maken: het begint allemaal bij dit endpoint.

In deze les leert u hoe u een verzoek voor afbeeldingsgeneratie opbouwt en begrijpt u de fundamentele parameters.

1
Generatie-endpoint
2
Beschikbare modellen
10
Maximaal aantal afbeeldingen per verzoek
2k
Maximale resolutie

Structuur van een generatieverzoek

Twee parameters volstaan om een afbeelding te genereren: het model en de prompt. Alle andere parameters hebben standaardwaarden, zodat u met drie regels code al een eerste resultaat krijgt. Doe dit vooral voordat u verder leest, zodat u een concrete afbeelding hebt waaraan u elke parameter kunt koppelen.

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.images.generate(
    model="grok-imagine-image",
    prompt="A Breton lighthouse under a starry sky, watercolor style"
)

image_url = response.data[0].url
print(image_url)

De xAI API is compatibel met de OpenAI SDK voor afbeeldingsgeneratie: u wijst de base_url naar https://api.x.ai/v1, voert uw xAI-sleutel in en de rest van uw code blijft ongewijzigd. Houd wel rekening met de reikwijdte van deze compatibiliteit: deze geldt voor generatie, maar niet voor bewerking, waarvoor een ander formaat vereist is. Les 5 behandelt dit onderwerp.

Verzoekparameters

Dit zijn de parameters die u in uw verzoek kunt opnemen:

  • model: het generatiemodel dat u wilt gebruiken (grok-imagine-image of grok-imagine-image-2.0, zie les 2)
  • prompt: de tekstuele beschrijving van de gewenste afbeelding
  • n: het aantal te genereren afbeeldingen (1 tot 10, standaard: 1)
  • aspect_ratio: de beeldverhouding van de afbeelding (auto als standaard: het model kiest op basis van de prompt)
  • resolution: de resolutie (1k als standaard, of 2k)
  • quality: low, medium of auto (standaard) bij Imagine 2.0, zie les 12
  • response_format: url (standaard) of b64_json om de afbeelding in Base64 te ontvangen

Voorbeeld met alle parameters

response = client.images.generate(
    model="grok-imagine-image",
    prompt="An enchanted forest with fireflies, digital art style",
    n=2,
    response_format="url",
    extra_body={"aspect_ratio": "16:9", "resolution": "2k"},
)

for image in response.data:
    print(image.url)

Responsformaat

Het antwoord is altijd een array, zelfs bij één enkele afbeelding. Itereer hierover in plaats van direct data[0] uit te lezen; anders faalt uw code op het moment dat u n=4 instelt. Elk object bevat:

  • url: de tijdelijke URL van de afbeelding (als response_format gelijk is aan url)
  • b64_json: de Base64-gegevens van de afbeelding (als response_format gelijk is aan b64_json)

Het geretourneerde MIME-type kan image/png, image/jpeg of image/webp zijn. Standaard is dit image/jpeg, tenzij een kwaliteitsinstelling leidt tot PNG.

Praktijkoefening

Probeer uw eerste afbeelding te genereren door de prompt aan te passen aan uw professionele context. Bijvoorbeeld voor een visueel element in een presentatie:

response = client.images.generate(
    model="grok-imagine-image",
    prompt="Minimalist chart showing startup growth, "
           "blue and white colors, dark background, flat design style",
    extra_body={"resolution": "2k", "aspect_ratio": "16:9"},
)

Belangrijkste punten

  • Het generatie-endpoint is POST /v1/images/generations
  • Twee parameters volstaan om te beginnen: model en prompt
  • De API is compatibel met de OpenAI Python SDK door de base_url aan te passen
  • U kunt tot 10 afbeeldingen per verzoek genereren
  • De beschikbare resoluties zijn 1k (standaard) en 2k