Endpoint /v1/images/generations: aan de slag
Op deze pagina
Les voltooid op 3 november 2026 op basis van de pagina Image Generation en de xAI Images API-referentie: standaardwaarden (
aspect_ratioingesteld opauto,resolutionop1k), de parameterqualityvoor Imagine 2.0, en JPEG als standaardformaat. Bronnen: Image Generation · Images API.
Genereer uw eerste afbeelding met de Grok API
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.
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-imageofgrok-imagine-image-2.0, zie les 2)prompt: de tekstuele beschrijving van de gewenste afbeeldingn: het aantal te genereren afbeeldingen (1 tot 10, standaard: 1)aspect_ratio: de beeldverhouding van de afbeelding (autoals standaard: het model kiest op basis van de prompt)resolution: de resolutie (1kals standaard, of2k)quality:low,mediumofauto(standaard) bij Imagine 2.0, zie les 12response_format:url(standaard) ofb64_jsonom 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 (alsresponse_formatgelijk is aanurl)b64_json: de Base64-gegevens van de afbeelding (alsresponse_formatgelijk is aanb64_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:
modelenprompt - De API is compatibel met de OpenAI Python SDK door de
base_urlaan te passen - U kunt tot 10 afbeeldingen per verzoek genereren
- De beschikbare resoluties zijn
1k(standaard) en2k