Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Generatsioon pakettides ja parameeter n

Õppetund 9 / 14 Värskendatud 2. november 2026 Algajatele
Sellel lehel
  1. Mitme pildi genereerimine ühes päringus
  2. Parameeter n lähemalt
  3. Mõju kuludele ja kiirusepiirangutele
  4. Valikustrateegiad
  5. Mitme vihje pakettimine
  6. Pakkide allalaadimine
  7. Peamised punktid

Uuendatud 2. novembril 2026 — Imagine. grok-imagine-image-quality eemaldati 2. novembril 2026 (selle päringuid teenindab nüüd Imagine 2.0 madalas kvaliteedis): näited kasutavad nüüd mudeleid grok-imagine-image (Imagine 1.0) ja grok-imagine-image-2.0 (Imagine 2.0, kvaliteediga low, medium või auto). OpenAI SDK puhul edastatakse aspect_ratio, resolution ja quality parameetri extra_body kaudu 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 n võ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