Endpoint /v1/images/generations: Kom godt i gang
På denne side
Lektion afsluttet den 3. november 2026 baseret på siden Image Generation og xAI Images API-referencen: standardværdier (
aspect_ratiosat tilauto,resolutiontil1k), parameterenqualitytil Imagine 2.0, og JPEG som standardformat. Kilder: Image Generation · Images API.
Generér dit første billede med Grok API
xAI API’et tilbyder et dedikeret endpoint til billedgenerering: POST /v1/images/generations. Dette endpoint lader dig skabe billeder ud fra en tekstbeskrivelse ved hjælp af Grok Imagine-modellerne. Uanset om du vil producere illustrationer, markedsføringsvisualiseringer eller kreative prototyper, starter det hele med dette endpoint.
I denne lektion lærer du, hvordan du strukturerer en anmodning om billedgenerering, og du får forståelse for de grundlæggende parametre.
Struktur på en genereringsanmodning
To parametre er nok til at generere et billede: modellen og prompten. Alle andre har standardværdier, hvilket betyder, at du kan få dit første resultat på bare tre linjer – og det er præcis, hvad du bør gøre, før du læser videre, så du har et billede foran dig, som du kan relatere hver parameter til.
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)
xAI API’et er kompatibelt med OpenAI SDK til billedgenerering: Du peger base_url mod https://api.x.ai/v1, angiver din xAI-nøgle, så forbliver resten af din kode uændret. Husk omfanget af denne kompatibilitet – den gælder for generering, men ikke for redigering, som forventer et andet format. Lektion 5 dækker dette.
Anmodningsparametre
Her er de parametre, du kan inkludere i din anmodning:
model: Genereringsmodellen, der skal bruges (grok-imagine-imageellergrok-imagine-image-2.0, se lektion 2)prompt: Tekstbeskrivelsen af det ønskede billeden: Antallet af billeder, der skal genereres (1 til 10, standard: 1)aspect_ratio: Billedets formatforhold (autosom standard: modellen vælger baseret på prompten)resolution: Opløsningen (1ksom standard eller2k)quality:low,mediumellerauto(standard) på Imagine 2.0, se lektion 12response_format:url(standard) ellerb64_jsonfor at modtage billedet i Base64
Eksempel med alle parametre
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)
Response-format
Svaret er altid et array, selv for et enkelt billede – iterér over det i stedet for at læse data[0], ellers vil din kode bryde sammen den dag, du sætter n=4. Hvert objekt indeholder:
url: Den midlertidige URL til billedet (hvisresponse_formaterurl)b64_json: Base64-dataene for billedet (hvisresponse_formaterb64_json)
Den returnerede MIME-type kan være image/png, image/jpeg eller image/webp; den er som standard image/jpeg, medmindre en kvalitetsindstilling producerer PNG.
Praktisk øvelse
Prøv at generere dit første billede ved at tilpasse prompten til din professionelle kontekst. For eksempel til en visualisering til en præsentation:
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"},
)
Vigtige pointer
- Genererings-endpointet er
POST /v1/images/generations - To parametre er nok til at komme i gang:
modelogprompt - API’et er kompatibelt med OpenAI Python SDK ved at ændre
base_url - Du kan generere op til 10 billeder pr. anmodning
- De tilgængelige opløsninger er
1k(standard) og2k