Endpoint /v1/images/generations: Első lépések
Ezen az oldalon
A leckét 2026. november 3-án fejeztük be a Képgenerálás oldal és az xAI Images API referenciája alapján: alapértelmezett értékek (
aspect_ratiobeállítvaauto-ra,resolution1k-ra), aqualityparaméter az Imagine 2.0-hoz, valamint a JPEG mint alapértelmezett formátum. Források: Képgenerálás · Images API.
Generáld az első képedet a Grok API-val
Az xAI API egy dedikált endpointot kínál képgeneráláshoz: POST /v1/images/generations. Ezzel az endpointtal szöveges leírás alapján hozhatsz létre képeket a Grok Imagine modellek segítségével. Legyen szó illusztrációkról, marketing anyagokról vagy kreatív prototípusokról, minden ennél az endpointnál kezdődik.
Ebben a leckében megtanulod, hogyan építsd fel a képgenerálási kérést, és megértsd az alapvető paramétereket.
A generálási kérés felépítése
Két paraméter is elég egy kép generálásához: a modell és a prompt (utasítás). Minden egyéb paraméternek van alapértelmezett értéke, így három sor kóddal máris kapsz egy első eredményt – és pontosan ezt kell tenned, mielőtt továbbolvasnál, hogy legyen egy kép a szemed előtt, amihez viszonyíthatod az egyes paramétereket.
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="Egy breton világítótorony csillagos égbolt alatt, akvarell stílusban"
)
image_url = response.data[0].url
print(image_url)
Az xAI API kompatibilis az OpenAI SDK-val képgenerálás terén: a base_url-t a https://api.x.ai/v1 címre állítod, megadod az xAI kulcsodat, és a kódod többi része változatlan marad. Tartsd észben ennek a kompatibilitásnak a hatókörét – ez a generálásra vonatkozik, de nem a szerkesztésre, amely más formátumot vár. Az 5. lecke ezt tárgyalja.
Kérési paraméterek
Íme a kérésedben használható paraméterek:
model: a használni kívánt generálási modell (grok-imagine-imagevagygrok-imagine-image-2.0, lásd a 2. leckét)prompt: a kívánt kép szöveges leírásan: a generálandó képek száma (1-től 10-ig, alapértelmezett: 1)aspect_ratio: a kép oldalaránya (alapértelmezett:auto: a modell a prompt alapján választ)resolution: a felbontás (alapértelmezett:1k, vagy2k)quality:low,mediumvagyauto(alapértelmezett) az Imagine 2.0 esetén, lásd a 12. leckétresponse_format:url(alapértelmezett) vagyb64_json, ha Base64 formátumban szeretnéd megkapni a képet
Példa az összes paraméterrel
response = client.images.generate(
model="grok-imagine-image",
prompt="Egy elvarázsolt erdő szentjánosbogarakkal, digitális művészet stílusban",
n=2,
response_format="url",
extra_body={"aspect_ratio": "16:9", "resolution": "2k"},
)
for image in response.data:
print(image.url)
Válasz formátuma
A válasz mindig egy tömb, még egyetlen kép esetén is – iterálj rajta, ahelyett, hogy közvetlenül a data[0]-t olvasnád ki, különben a kódod elszáll, amikor egyszer n=4-re állítod a paramétert. Minden objektum a következőket tartalmazza:
url: a kép ideiglenes URL-címe (ha aresponse_formatértékeurl)b64_json: a kép Base64 adatai (ha aresponse_formatértékeb64_json)
A visszaadott MIME típus lehet image/png, image/jpeg vagy image/webp; alapértelmezés szerint image/jpeg, kivéve, ha egy minőségi beállítás PNG-t eredményez.
Gyakorlati feladat
Próbáld meg generálni az első képedet úgy, hogy az utasítást (prompt) a saját szakmai környezetedhez igazítod. Például egy prezentációhoz szükséges vizuális elemhez:
response = client.images.generate(
model="grok-imagine-image",
prompt="Minimalista diagram, amely egy startup növekedését mutatja, "
"kék és fehér színek, sötét háttér, lapos design stílus",
extra_body={"resolution": "2k", "aspect_ratio": "16:9"},
)
Főbb megállapítások
- A generálási endpoint:
POST /v1/images/generations - Két paraméter elég a kezdéshez:
modelésprompt - Az API kompatibilis az OpenAI Python SDK-val a
base_urlmódosításával - Kérésenként legfeljebb 10 képet generálhatsz
- Az elérhető felbontások:
1k(alapértelmezett) és2k