Generácia dávok a parameter n
Na tejto strane
Aktualizované 2. novembra 2026 — Imagine. Model
grok-imagine-image-qualitybol 2. novembra 2026 odstránený (jeho požiadavky sú teraz obsluhované modelom Imagine 2.0 v kvalitelow): príklady teraz využívajúgrok-imagine-image(Imagine 1.0) agrok-imagine-image-2.0(Imagine 2.0, kvalitalow,mediumaleboauto). Pri používaní OpenAI SDK sa parametreaspect_ratio,resolutionaqualityodovzdávajú cezextra_body, zatiaľ čo úpravy sa riešia prostredníctvom xAI SDK alebo HTTP požiadavky.
Generovanie viacerých obrázkov v jednej požiadavke
Parameter n v API pre generovanie ti umožňuje vytvoriť až 10 obrázkov z jedného promptu. Každý obrázok je jedinečná variácia, čo ti poskytuje široký výber na vybranie najlepšieho výsledku alebo zostavenie galérie vizuálov.
Parameter n v detailoch
Parameter n prijíma celé číslo medzi 1 a 10, pričom predvolená hodnota je 1. Jeho skutočná hodnota spočíva vo vlastnosti generovania obrázkov, na ktorú sa často zabúda: výsledok je nedeterministický. Ten istý prompt vygeneruje zakaždým iné obrázky a žiadny z nich nie je „správnejší“ než ostatné. Generovanie štyroch variácií naraz nie je plytvanie – je to uznanie faktu, že vopred nevieš, ktorá verzia bude fungovať.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
# Generovanie 5 variácií
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}")
Vplyv na náklady a limity rýchlosti
Kľúčová vec, ktorú musíš pochopiť pred zostavením pipeline na tomto základe: n=10 nie je zľava. Platíš za desať obrázkov a spotrebuješ desať jednotiek limitu rýchlosti, presne ako pri desiatich samostatných volaniach. Jediným ziskom je sieť – jedna odozva namiesto desiatich – čo pomáha latencii, ale nemení rozpočet.
| Parameter | n=1 | n=5 | n=10 |
|---|---|---|---|
| Náklady (Imagine 1.0) | $0.02 | $0.10 | $0.20 |
| Náklady (Imagine 2.0, low) | $0.04 | $0.20 | $0.40 |
| Vygenerované obrázky | 1 | 5 | 10 |
Požiadavka s n=10 spotrebuje rovnaký rozpočet ako 10 individuálnych požiadaviek s n=1, ale je rýchlejšia, pretože vyžaduje iba jedno sieťové volanie.
Stratégie výberu
Generovanie desiatich variácií bez metódy triedenia len presúva problém: mal si jeden neistý obrázok, teraz máš desať obrázkov na posúdenie. Prvou otázkou, ktorú si musíš vyjasniť, je kritérium – estetické, kde ľudské oko zostáva neprekonateľné; alebo overiteľné (je produkt viditeľný, je text čitateľný, je formát dodržaný), kde je možná automatizácia.
Manuálny výber
Pre kritické prípady (reklama, obálky kníh) si stiahni všetky variácie a vizuálne ich porovnaj:
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")
Automatizovaný výber
Použitie vizuálneho modelu na posúdenie obrázkov funguje za jednej podmienky: kritérium musí byť faktické. Na otázku „Obsahuje tento obrázok produkt umiestnený v strede na jednoliatom pozadí?“ dostaneš spoľahlivú odpoveď; na otázku „Ktorý je najkrajší?“ dostaneš ľubovoľnú odpoveď predloženú s istotou. Formuluj overiteľné kritériá a estetické posudzovanie si nechaj na seba.
def generate_and_select(prompt, n=5):
"""Generuje n variácií a vráti všetky URL."""
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=n
)
return [image.url for image in response.data]
Dávkové spracovanie viacerých promptov
Na generovanie obrázkov z viacerých rôznych promptov kombinuj volania:
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 prompty x 3 variácie = 9 obrázkov, celkové náklady: $0.18
Dávkové sťahovanie
Toto je zvyk, ktorý si musíš osvojiť už pri prvom riadku kódu, nie až pri nasadení do produkcie: URL adresy expirujú. Dávka desiatich obrázkov vygenerovaná ráno a stiahnutá večer je stratená dávka – a budeš za ňu musieť znova zaplatiť.
import urllib.request
import os
def download_batch(response, output_dir="generated"):
"""Stiahne všetky obrázky z odpovede."""
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}/")
Ceny platné k 5. augustu 2026 – ceny sa pravidelne menia: pred akýmkoľvek výpočtom rozpočtu si over aktuálny cenník na oficiálnej stránke modelov a cien xAI.
Kľúčové poznatky
- Parameter
nti umožňuje generovať 1 až 10 variácií na jednu požiadavku - Každý obrázok sa započítava individuálne do fakturácie
- Generovanie v dávke (jedna požiadavka s n>1) je rýchlejšie ako n individuálnych požiadaviek
- Výsledky si stiahni okamžite, pretože URL adresy sú dočasné
- Použi n=3 až 5 na prieskum, n=1 pre cielenú produkciu