Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Endpoint /v1/images/generations: Első lépések

1. lecke 14 közül Frissítve 2026. november 3. Kezdő
Ezen az oldalon
  1. Generáld az első képedet a Grok API-val
  2. A generálási kérés felépítése
  3. Kérési paraméterek
  4. Válasz formátuma
  5. Gyakorlati feladat
  6. Főbb megállapítások

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_ratio beállítva auto-ra, resolution 1k-ra), a quality paramé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

Grok által generált kép 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.

1
Generálási Endpoint
2
Elérhető Modellek
10
Maximális képek száma kérésenként
2k
Maximális felbontás

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-image vagy grok-imagine-image-2.0, lásd a 2. leckét)
  • prompt: a kívánt kép szöveges leírása
  • n: 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, vagy 2k)
  • quality: low, medium vagy auto (alapértelmezett) az Imagine 2.0 esetén, lásd a 12. leckét
  • response_format: url (alapértelmezett) vagy b64_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 a response_format értéke url)
  • b64_json: a kép Base64 adatai (ha a response_format értéke b64_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 és prompt
  • Az API kompatibilis az OpenAI Python SDK-val a base_url módosításával
  • Kérésenként legfeljebb 10 képet generálhatsz
  • Az elérhető felbontások: 1k (alapértelmezett) és 2k