Kötegelt generálás és az n paraméter
Ezen az oldalon
Frissítve: 2026. november 2. — Imagine. A
grok-imagine-image-qualitymodellt 2026. november 2-án megszüntették (a kéréseit mostantól az Imagine 2.0 szolgálja kilowminőségben): a példák most agrok-imagine-image(Imagine 1.0) és agrok-imagine-image-2.0(Imagine 2.0,low,mediumvagyautominőség) modelleket használják. Az OpenAI SDK-val azaspect_ratio,resolutionésqualityparamétereket azextra_bodyobjektumon keresztül adjuk át, míg a szerkesztést az xAI SDK-val vagy közvetlen HTTP-kéréssel végezzük.
Több kép generálása egyetlen kérésben
A generálási API n paramétere lehetővé teszi, hogy egyetlen promptból akár 10 képet is előállíts. Minden kép egyedi variáció, így választási lehetőséged nyílik a legjobb eredmény kiválasztására, vagy vizuális galéria összeállítására.
Az n paraméter részletesen
Az n paraméter egy 1 és 10 közötti egész számot fogad el, alapértelmezett értéke pedig 1. Valódi jelentősége a képgenerálás egy gyakran elfelejtett tulajdonságában rejlik: az eredmény nem determinisztikus. Ugyanaz a prompt minden híváskor eltérő képeket eredményez, és egyik sem „helyesebb“ a másiknál. Négy variáció egyszerre történő generálása nem pazarlás; annak elismerése, hogy előre nem tudhatod, melyik lesz a megfelelő.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
# 5 variáció generálása
response = client.images.generate(
model="grok-imagine-image",
prompt="A zen Japanese garden with a red bridge, ukiyo-e style",
n=5,
extra_body={"aspect_ratio": "16:9", "resolution": "1k"},
)
for i, image in enumerate(response.data):
print(f"Variation {i + 1}: {image.url}")
Hatás a költségekre és a sebességkorlátokra
Mielőtt erre alapoznál bármilyen folyamatot, ezt a legfontosabbat értsd meg: az n=10 nem kedvezmény. Tíz képért fizetsz, és tíz egységnyi sebességkorlátot (rate limit) fogyasztasz el, pontosan úgy, mint tíz különálló hívás esetén. Az egyetlen nyereség a hálózat: egyetlen oda-vissza út tíz helyett, ami csökkenti a késleltetést, de a költségvetésen nem változtat.
| Paraméter | n=1 | n=5 | n=10 |
|---|---|---|---|
| Költség (Imagine 1.0) | $0.02 | $0.10 | $0.20 |
| Költség (Imagine 2.0, low) | $0.04 | $0.20 | $0.40 |
| Generált képek száma | 1 | 5 | 10 |
Egy n=10 paraméterű kérés ugyanannyi költségvetést emészt fel, mint 10 különálló n=1 kérés, de gyorsabb, mivel csak egyetlen hálózati hívást igényel.
Kiválasztási stratégiák
Tíz variáció generálása rendezési módszer nélkül csupán eltolja a problémát: volt egy bizonytalan képed, most pedig tíz képet kell megítélned. Először a kritériumot kell tisztázni: esztétikai (ahol az emberi szem verhetetlen), vagy ellenőrizhető (látható-e a termék, olvasható-e a szöveg, betartott-e a formátum), ahol az automatizálás lehetséges.
Manuális kiválasztás
Kritikus esetekben (reklám, könyvborítók) töltsd le az összes variációt, és hasonlítsd össze őket vizuálisan:
import urllib.request
response = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Science fiction book cover, organic spaceship",
n=8,
extra_body={"aspect_ratio": "3:4", "resolution": "2k"},
)
for i, image in enumerate(response.data):
urllib.request.urlretrieve(image.url, f"variation_{i + 1}.png")
print(f"Variation {i + 1} saved")
Automatizált kiválasztás
Egy vision modell segítségével történő kiértékelés csak egy feltétellel működik: a kritériumnak tényalapúnak kell lennie. A „Tartalmaz-e ez a kép egy terméket tömör háttér előtt?“ kérdésre megbízható választ kapsz; a „Melyik a legszebb?“ kérdésre önkényes választ kapsz, magabiztos tálalásban. Fogalmazz meg ellenőrizhető kritériumokat, az esztétikai ítélkezést pedig tartsd meg magadnak.
def generate_and_select(prompt, n=5):
"""Generál n variációt, és visszaadja az összes URL-t."""
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=n
)
return [image.url for image in response.data]
Több prompt kötegelt feldolgozása
Ha több különböző promptból szeretnél képeket generálni, kombináld a hívásokat:
prompts = [
"Illustration of a Parisian café, impressionist style",
"Aerial view of terraced rice fields, photographic style",
"Interior of an old library, dim lighting"
]
all_results = {}
for prompt in prompts:
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=3
)
all_results[prompt] = [img.url for img in response.data]
# 3 prompt x 3 variáció = 9 kép, teljes költség: $0.18
Kötegelt letöltés
Ezt a szokást már az első kódsor megírásakor alakítsd ki, ne csak a productionba való telepítéskor: az URL-ek lejárnak. Egy reggel generált és este letöltött tízképes köteg elveszett köteg – és újra fizetned kell érte.
import urllib.request
import os
def download_batch(response, output_dir="generated"):
"""Letölti az összes képet egy válaszból."""
os.makedirs(output_dir, exist_ok=True)
for i, image in enumerate(response.data):
filepath = os.path.join(output_dir, f"image_{i + 1}.png")
urllib.request.urlretrieve(image.url, filepath)
print(f"{len(response.data)} images saved in {output_dir}/")
Árazás: 2026. augusztus 5. – az árak rendszeresen változnak: bármilyen költségvetési számítás előtt ellenőrizd az aktuális díjszabást a hivatalos xAI modell- és árinformációs oldalon.
Főbb megállapítások
- Az
nparaméter lehetővé teszi 1–10 variáció generálását kérésenként - Minden kép egyedileg számít a számlázásnál
- A kötegelt generálás (egy kérés n>1 paraméterrel) gyorsabb, mint n különálló kérés
- Azonnal töltsd le az eredményeket, mivel az URL-ek ideiglenesek
- Használj n=3–5 értéket a felfedezéshez, n=1-et a célzott gyártáshoz