Generování dávek a parametr n
Na této stránce
Aktualizováno 2. listopadu 2026 — Imagine. Model
grok-imagine-image-qualitybyl 2. listopadu 2026 odstraněn (jeho požadavky jsou nyní obsluhovány modelem Imagine 2.0 v kvalitělow): příklady nyní využívajígrok-imagine-image(Imagine 1.0) agrok-imagine-image-2.0(Imagine 2.0, kvalitalow,mediumneboauto). Při použití OpenAI SDK se parametryaspect_ratio,resolutionaqualitypředávají prostřednictvímextra_body, zatímco úpravy se řeší přes xAI SDK nebo HTTP požadavek.
Generování více obrázků v jediném požadavku
Parametr n v API pro generování ti umožní vytvořit až 10 obrázků z jednoho promptu. Každý obrázek je jedinečná variace, což ti poskytuje široký výběr pro nalezení nejlepšího výsledku nebo vytvoření galerie vizuálů.
Parametr n v detailu
Parametr n přijímá celé číslo mezi 1 a 10, přičemž výchozí hodnota je 1. Jeho skutečná hodnota spočívá ve vlastnosti generování obrázků, na kterou se snadno zapomíná: výsledek je nedeterministický. Stejný prompt pokaždé vygeneruje jiné obrázky a žádný z nich není „správnější“ než ten druhý. Generování čtyř variací najednou není plýtvání – je to uznání faktu, že předem nevíš, která z nich bude fungovat.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
# Generování 5 variací
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}")
Dopad na náklady a limity rychlosti
Klíčová věc, kterou musíš pochopit před sestavením pipeline na tomto principu: n=10 není sleva. Platíš za deset obrázků a spotřebuješ deset jednotek limitu rychlosti, přesně jako u deseti samostatných volání. Jediným ziskem je síť – jedna往返 místo deseti – což pomáhá latenci, ale nemění rozpočet.
| Parameter | n=1 | n=5 | n=10 |
|---|---|---|---|
| Cost (Imagine 1.0) | $0.02 | $0.10 | $0.20 |
| Cost (Imagine 2.0, low) | $0.04 | $0.20 | $0.40 |
| Images generated | 1 | 5 | 10 |
Požadavek s n=10 spotřebuje stejný rozpočet jako 10 jednotlivých požadavků s n=1, ale je rychlejší, protože vyžaduje pouze jedno síťové volání.
Strategie výběru
Generování deseti variací bez metody třídění pouze přesune problém: měl jsi jeden nejistý obrázek, nyní máš deset obrázků k posouzení. První otázkou, kterou si musíš vyjasnit, je kritérium – estetické, kde lidské oko zůstává nepřekonatelné, nebo ověřitelné (je produkt viditelný, je text čitelný, je dodržen formát), kde je možná automatizace.
Ruční výběr
U kritických případů (reklama, obálky knih) si stáhni všechny variace a porovnej je vizuálně:
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ýběr
Nechat model pro analýzu obrazu (vision model) posoudit obrázky funguje pouze za jedné podmínky: kritérium musí být faktické. Na otázku „Obsahuje tento obrázek produkt umístěný uprostřed na jednolitém pozadí?“ získáš spolehlivou odpověď; na otázku „Který je nejkrásnější?“ získáš libovolnou odpověď prezentovanou s jistotou. Formuluj ověřitelná kritéria a estetické posuzování si nech pro sebe.
def generate_and_select(prompt, n=5):
"""Generuje n variací a vrátí všechny URL."""
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=n
)
return [image.url for image in response.data]
Dávkové zpracování více promptů
Chceš-li generovat obrázky z více různých promptů, zkombinuj volání:
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 variace = 9 obrázků, celkové náklady: $0.18
Dávkové stahování
Toto je zvyk, který si musíš osvojit od prvního řádku kódu, ne až při nasazení do produkce: URL adresy expirují. Dávka deseti obrázků vygenerovaná ráno a stažená večer je ztracená dávka – a budeš za ni muset zaplatit znovu.
import urllib.request
import os
def download_batch(response, output_dir="generated"):
"""Stáhne všechny obrázky z odpovědi."""
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. srpnu 2026 – ceny se pravidelně mění: před jakýmkoli výpočtem rozpočtu si ověř aktuální ceník na oficiální stránce modelů a cen xAI.
Klíčové poznatky
- Parametr
nti umožňuje generovat 1 až 10 variací na jeden požadavek - Každý obrázek se započítává individuálně pro fakturaci
- Generování v dávce (jeden požadavek s n>1) je rychlejší než n jednotlivých požadavků
- Výsledky stahuj okamžitě, protože URL adresy jsou dočasné
- Pro průzkum používej n=3 až 5, pro cílenou produkci n=1