Erägenerointi ja n-parametri
Tällä sivulla
Päivitetty 2. marraskuuta 2026 — Imagine.
grok-imagine-image-qualitypoistettiin käytöstä 2. marraskuuta 2026 (sen pyynnöt käsitellään nyt Imagine 2.0:llalow-laadulla): esimerkit käyttävät nyt mallejagrok-imagine-image(Imagine 1.0) jagrok-imagine-image-2.0(Imagine 2.0, laatulow,mediumtaiauto). OpenAI SDK:n kautta välitettävät parametritaspect_ratio,resolutionjaqualitysijoitetaan kohtaanextra_body, kun taas kuvan muokkaus hoidetaan xAI SDK:lla tai HTTP-pyynnöllä.
Useiden kuvien generointi yhdellä pyynnöllä
Generointi-API:n n-parametrin avulla voit tuottaa jopa 10 kuvaa yhdestä kehotteesta. Jokainen kuva on ainutlaatuinen variaatio, mikä antaa sinulle valikoiman vaihtoehtoja parhaan tuloksen valitsemiseksi tai visuaalisen gallerian rakentamiseksi.
n-parametri tarkemmin
n-parametri hyväksyy kokonaisluvun väliltä 1–10, ja sen oletusarvo on 1. Sen todellinen arvo piilee kuvageneroinnin ominaisuudessa, joka on helppo unohtaa: tulos on ei-deterministinen. Sama kehote tuottaa erilaisia kuvia joka kerta, kun kutsut sitä, eikä mikään niistä ole “oikeampi” kuin toinen. Neljän variaation generointi kerralla ei ole hukkaa – se on tunnustusta sille, ettei etukäteen tiedä, mikä niistä toimii parhaiten.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
# Generoi 5 variaatiota
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}")
Vaikutus kustannuksiin ja nopeusrajoituksiin
Tärkein asia ymmärtää ennen putken rakentamista tämän ympärille: n=10 ei ole alennus. Maksat kymmenestä kuvasta ja kulutat kymmenen yksikköä nopeusrajoituksesta, aivan kuten kymmenellä erillisellä kutsulla. Ainoa hyöty on verkossa – yksi verkkokutsu kymmenen sijaan – mikä parantaa viivettä, mutta ei muuta budjettia.
| Parametri | n=1 | n=5 | n=10 |
|---|---|---|---|
| Kustannus (Imagine 1.0) | $0.02 | $0.10 | $0.20 |
| Kustannus (Imagine 2.0, low) | $0.04 | $0.20 | $0.40 |
| Generoidut kuvat | 1 | 5 | 10 |
Pyyntö, jossa n=10, kuluttaa saman budjetin kuin 10 yksittäistä pyyntöä arvolla n=1, mutta se on nopeampi, koska se vaatii vain yhden verkkokutsun.
Valintastrategiat
Kymmenen variaation generointi ilman lajittelumenetelmää vain siirtää ongelmaa: sinulla oli yksi epävarma kuva, nyt sinulla on kymmenen kuvaa arvioitavana. Ensimmäinen ratkaistava kysymys on kriteeri: esteettinen, jossa ihmisen silmä on lyömätön; tai varmennettava (onko tuote näkyvissä, onko teksti luettava, onko formaatti oikea), jossa automaatio on mahdollista.
Manuaalinen valinta
Kriittisissä tapauksissa (mainonta, kirjan kannet) lataa kaikki variaatiot ja vertaa niitä visuaalisesti:
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")
Automatisoitu valinta
Näkömallin käyttäminen kuvien arviointiin toimii yhdellä ehdolla: kriteerin on oltava faktuaalinen. Kysymykseen “Sisältääkö tämä kuva tuotteen keskitettynä yhtenäiselle taustalle?” saat luotettavan vastauksen; kysymykseen “Mikä niistä on kaunein?” saat mielivaltaisen vastauksen, joka esitetään itsevarmasti. Muotoile varmennettavat kriteerit ja pidä esteettinen arviointi itselläsi.
def generate_and_select(prompt, n=5):
"""Generoi n variaatiota ja palauta kaikki URL-osoitteet."""
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=n
)
return [image.url for image in response.data]
Useiden kehotteiden eräytys
Generoidaksesi kuvia useista eri kehotteista yhdistä kutsut:
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 kehotetta x 3 variaatiota = 9 kuvaa, kokonaiskustannus: $0.18
Erälataus
Tämä on tapa, joka on omaksuttava jo ensimmäisestä koodirivistä lähtien, ei vasta tuotantoon vietäessä: URL-osoitteet vanhentuvat. Aamulla generoitu ja illalla ladattu kymmenen kuvan erä on menetetty erä – ja joudut maksamaan siitä uudelleen.
import urllib.request
import os
def download_batch(response, output_dir="generated"):
"""Lataa kaikki kuvat vastauksesta."""
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}/")
Hinnoittelu 5. elokuuta 2026 alkaen – hinnat muuttuvat säännöllisesti: ennen kuin teet budjettilaskelmia, tarkista nykyinen hintalista xAI:n viralliselta mallien ja hinnoittelun sivulta.
Keskeiset asiat
n-parametrin avulla voit generoida 1–10 variaatiota pyyntöä kohden- Jokainen kuva laskutetaan erikseen
- Erägenerointi (yksi pyyntö, jossa n>1) on nopeampaa kuin n yksittäistä pyyntöä
- Lataa tulokset välittömästi, koska URL-osoitteet ovat väliaikaisia
- Käytä arvoa n=3–5 tutkimiseen ja arvoa n=1 kohdennettuun tuotantoon