Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Endpoint /v1/images/generations: Začíname

Lekcia 1 z 14 Aktualizované 3. novembra 2026 Začiatočník
Na tejto strane
  1. Vygeneruj svoj prvý obrázok pomocou Grok API
  2. Štruktúra požiadavky na generovanie
  3. Parametre požiadavky
  4. Formát odpovede
  5. Praktické cvičenie
  6. Kľúčové poznatky

Lekcia dokončená 3. novembra 2026 na základe stránky Image Generation a referencie xAI Images API: predvolené hodnoty (aspect_ratio nastavené na auto, resolution na 1k), parameter quality pre Imagine 2.0 a JPEG ako predvolený formát. Zdroje: Image Generation · Images API.

Vygeneruj svoj prvý obrázok pomocou Grok API

Obrázok vygenerovaný systémom Grok API xAI ponúka vyhradený endpoint na generovanie obrázkov: POST /v1/images/generations. Tento endpoint ti umožňuje vytvárať obrázky z textového popisu pomocou modelov Grok Imagine. Či už chceš produkovať ilustrácie, marketingové vizuály alebo kreatívne prototypy, všetko začína práve týmto endpointom.

V tejto lekcii sa naučíš, ako štruktúrovať požiadavku na generovanie obrázka a pochopíš základné parametre.

1
Endpoint pre generovanie
2
Dostupné modely
10
Maximálny počet obrázkov na požiadavku
2k
Maximálne rozlíšenie

Štruktúra požiadavky na generovanie

Na vygenerovanie obrázka stačia dva parametre: model a prompt (príkaz). Všetky ostatné majú predvolené hodnoty, čo ti umožní získať prvý výsledok na troch riadkoch – a presne to by si mal urobiť skôr, než budeš čítať ďalej, aby si mal pred sebou obrázok, ku ktorému si môžeš priradiť každý parameter.

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)

API xAI je kompatibilné so SDK OpenAI pre generovanie obrázkov: stačí nasmerovať base_url na https://api.x.ai/v1, poskytnúť svoj kľúč xAI a zvyšok kódu zostane nezmenený. Maj na pamäti rozsah tejto kompatibility – platí pre generovanie, ale nie pre úpravy, ktoré očakávajú iný formát. Túto tému pokrýva lekcia 5.

Parametre požiadavky

Tu sú parametre, ktoré môžeš zahrnúť do svojej požiadavky:

  • model: model na generovanie (grok-imagine-image alebo grok-imagine-image-2.0, pozri lekciu 2)
  • prompt: textový popis požadovaného obrázka
  • n: počet obrázkov na vygenerovanie (1 až 10, predvolené: 1)
  • aspect_ratio: pomer strán obrázka (predvolené auto: model vyberie podľa promptu)
  • resolution: rozlíšenie (predvolené 1k alebo 2k)
  • quality: low, medium alebo auto (predvolené) pri Imagine 2.0, pozri lekciu 12
  • response_format: url (predvolené) alebo b64_json pre prijatie obrázka v Base64

Príklad so všetkými parametrami

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)

Formát odpovede

Odpoveď je vždy poľom (array), aj pri jednom obrázku – iteruj cezňu namiesto čítania data[0], inak sa ti kód pokazí v deň, keď nastavíš n=4. Každý objekt obsahuje:

  • url: dočasnú URL adresu obrázka (ak je response_format nastavené na url)
  • b64_json: údaje obrázka v Base64 (ak je response_format nastavené na b64_json)

Vrátený typ MIME môže byť image/png, image/jpeg alebo image/webp; predvolený je image/jpeg, pokiaľ nastavenie kvality nevyprodukuje PNG.

Praktické cvičenie

Skús vygenerovať svoj prvý obrázok úpravou promptu podľa svojho profesionálneho kontextu. Napríklad pre vizuál do prezentácie:

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"},
)

Kľúčové poznatky

  • Endpoint pre generovanie je POST /v1/images/generations
  • Na začiatok stačia dva parametre: model a prompt
  • API je kompatibilné s Python SDK od OpenAI zmenou base_url
  • Na jednu požiadavku môžeš vygenerovať až 10 obrázkov
  • Dostupné rozlíšenia sú 1k (predvolené) a 2k