Generatsioon pakettides ja parameeter n
Sellel lehel
Uuendatud 2. novembril 2026 — Imagine.
grok-imagine-image-qualityeemaldati 2. novembril 2026 (selle päringuid teenindab nüüd Imagine 2.0 madalas kvaliteedis): näited kasutavad nüüd mudeleidgrok-imagine-image(Imagine 1.0) jagrok-imagine-image-2.0(Imagine 2.0, kvaliteedigalow,mediumvõiauto). OpenAI SDK puhul edastatakseaspect_ratio,resolutionjaqualityparameetriextra_bodykaudu ning redigeerimist hallatakse xAI SDK või HTTP-päringu abil.
Mitme pildi genereerimine ühes päringus
Generatsiooni API parameeter n võimaldab sul ühest vihjest luua kuni 10 pilti. Iga pilt on unikaalne variatsioon, pakkudes sulle valikuid parima tulemuse leidmiseks või visuaalide galerii loomiseks.
Parameeter n lähemalt
Parameeter n aktsepteerib täisarvu vahemikus 1 kuni 10 ja vaikimisi väärtus on 1. Selle tegelik väärtus peitub pildigeneratsiooni omaduses, mida on lihtne unustada: tulemus on mitteterministlik. Sama vihje toodab iga kutsu korral erinevaid pilte ja ükski neist pole teisest “õigem”. Nelja variatsiooni korraga genereerimine pole raiskamine – see on tunnistus, et sa ei tea ette, milline neist sobib.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
# Genereeri 5 variatsiooni
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}")
Mõju kuludele ja kiirusepiirangutele
Enne sellele põhineva torustiku loomist on oluline mõista üht asja: n=10 ei ole soodustus. Sa maksad kümne pildi eest ja tarbid kümme ühikut kiirusepiirangust, täpselt nagu kümne eraldi kutse korral. Ainus võit on võrgus – üks ringkäik kümne asemel –, mis parandab latentsust, kuid ei muuda eelarvet.
| Parameeter | n=1 | n=5 | n=10 |
|---|---|---|---|
| Kulu (Imagine 1.0) | $0.02 | $0.10 | $0.20 |
| Kulu (Imagine 2.0, low) | $0.04 | $0.20 | $0.40 |
| Genereeritud pilte | 1 | 5 | 10 |
Päring väärtusega n=10 tarbib sama eelarve kui 10 individuaalset päringut väärtusega n=1, kuid on kiirem, kuna nõuab vaid ühte võrgukutset.
Valikustrateegiad
Kümne variatsiooni genereerimine ilma sorteerimismeetodita nihutab probleemi lihtsalt edasi: sul oli üks ebakindel pilt, nüüd on sul kümme pilti, mida hinnata. Esimene küsimus, millele vastata, on kriteerium – kas esteetiline, kus inimlik silm on löömatus, või kontrollitav (kas toode on nähtav, kas tekst on loetav, kas formaati on järgitud), kus automatiseerimine on võimalik.
Manuaalne valik
Kriitilistel juhtudel (reklaam, raamatukaaned) laadi alla kõik variatsioonid ja võrdle neid visuaalselt:
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")
Automatiseeritud valik
Visioonimudeli kasutamine piltide hindamiseks toimib ühel tingimusel: kriteerium peab olema faktiline. Küsimus „Kas see pilt sisaldab toodet, mis on tsentreeritud ühtlasele taustale?“ saab usaldusväärse vastuse; küsimus „Milline neist on kõige ilusam?“ saab suvalise vastuse, mis esitatakse enesekindlalt. Sõnasta kontrollitavad kriteeriumid ja jäta esteetiline hindamine endale.
def generate_and_select(prompt, n=5):
"""Genereeri n variatsiooni ja tagasta kõik URL-id."""
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=n
)
return [image.url for image in response.data]
Mitme vihje pakettimine
Et genereerida pilte mitmest erinevast vihjest, kombineeri kutsed:
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 vihjet x 3 variatsiooni = 9 pilti, kogukulu: $0.18
Pakkide allalaadimine
See on harjumus, mille tuleb kujundada juba esimesest koodireast, mitte alles tootmisse viimisel: URL-id aeguvad. Hommikul genereeritud ja õhtul allalaetud kümne pildi pakk on kadunud pakk – ja sa pead selle eest uuesti maksma.
import urllib.request
import os
def download_batch(response, output_dir="generated"):
"""Laadi alla kõik pildid vastusest."""
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}/")
Hinnad seisuga 5. august 2026 – hinnad muutuvad regulaarselt: enne eelarve arvutamist kontrolli kehtivat hinnakirja xAI ametlikul mudelite ja hindade lehel.
Peamised punktid
- Parameeter
nvõimaldab genereerida 1 kuni 10 variatsiooni ühe päringuga - Iga pilt loetakse arveldamisel eraldi
- Pakkides genereerimine (üks päring, kus n>1) on kiirem kui n individuaalset päringut
- Laadi tulemused kohe alla, kuna URL-id on ajutised
- Kasuta uurimiseks väärtust n=3 kuni 5 ja sihipäraseks tootmiseks väärtust n=1