Endpoint /v1/images/generations: Začíname
Na tejto strane
Lekcia dokončená 3. novembra 2026 na základe stránky Image Generation a referencie xAI Images API: predvolené hodnoty (
aspect_rationastavené naauto,resolutionna1k), parameterqualitypre Imagine 2.0 a JPEG ako predvolený formát. Zdroje: Image Generation · Images API.
Vygeneruj svoj prvý obrázok pomocou Grok API
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.
Š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-imagealebogrok-imagine-image-2.0, pozri lekciu 2)prompt: textový popis požadovaného obrázkan: 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é1kalebo2k)quality:low,mediumaleboauto(predvolené) pri Imagine 2.0, pozri lekciu 12response_format:url(predvolené) alebob64_jsonpre 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 jeresponse_formatnastavené naurl)b64_json: údaje obrázka v Base64 (ak jeresponse_formatnastavené nab64_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:
modelaprompt - 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é) a2k