Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Erägenerointi ja n-parametri

Oppitunti 9 / 14 Päivitetty 2. marraskuuta 2026 Aloittelija
Tällä sivulla
  1. Useiden kuvien generointi yhdellä pyynnöllä
  2. n-parametri tarkemmin
  3. Vaikutus kustannuksiin ja nopeusrajoituksiin
  4. Valintastrategiat
  5. Useiden kehotteiden eräytys
  6. Erälataus
  7. Keskeiset asiat

Päivitetty 2. marraskuuta 2026 — Imagine. grok-imagine-image-quality poistettiin käytöstä 2. marraskuuta 2026 (sen pyynnöt käsitellään nyt Imagine 2.0:lla low-laadulla): esimerkit käyttävät nyt malleja grok-imagine-image (Imagine 1.0) ja grok-imagine-image-2.0 (Imagine 2.0, laatu low, medium tai auto). OpenAI SDK:n kautta välitettävät parametrit aspect_ratio, resolution ja quality sijoitetaan kohtaan extra_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