Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Endpoint /v1/images/generations: Kom godt i gang

Lektion 1 af 14 Opdateret 3. november 2026 Begynder
På denne side
  1. Generér dit første billede med Grok API
  2. Struktur på en genereringsanmodning
  3. Anmodningsparametre
  4. Response-format
  5. Praktisk øvelse
  6. Vigtige pointer

Lektion afsluttet den 3. november 2026 baseret på siden Image Generation og xAI Images API-referencen: standardværdier (aspect_ratio sat til auto, resolution til 1k), parameteren quality til Imagine 2.0, og JPEG som standardformat. Kilder: Image Generation · Images API.

Generér dit første billede med Grok API

Billede genereret af Grok 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.

1
Genererings-endpoint
2
Tilgængelige modeller
10
Maks. billeder pr. anmodning
2k
Maksimal opløsning

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-image eller grok-imagine-image-2.0, se lektion 2)
  • prompt: Tekstbeskrivelsen af det ønskede billede
  • n: Antallet af billeder, der skal genereres (1 til 10, standard: 1)
  • aspect_ratio: Billedets formatforhold (auto som standard: modellen vælger baseret på prompten)
  • resolution: Opløsningen (1k som standard eller 2k)
  • quality: low, medium eller auto (standard) på Imagine 2.0, se lektion 12
  • response_format: url (standard) eller b64_json for 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 (hvis response_format er url)
  • b64_json: Base64-dataene for billedet (hvis response_format er b64_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: model og prompt
  • 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) og 2k