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

Laatuparametri ja renderöinnin optimointi

Oppitunti 12 / 14 Päivitetty 2. marraskuuta 2026 Aloittelija
Tällä sivulla
  1. Tuotannon laadun hallinta
  2. quality-parametri
  3. Malli + quality + resoluutio -yhdistelmä
  4. 3-vaiheinen optimointityönkulku
  5. Automatisoi laadun valinta
  6. Keskeiset asiat

Oppitunti kirjoitettu uudelleen 2. marraskuuta 2026. Edellinen versio kuvasi high-arvoa ja quality-parametria, jotka eivät vaikuttaneet hintaan nyt jo eläkkeelle siirtyneelle “pro”-mallille. xAI:n nykyisen dokumentaation mukaan quality on ominainen Imagine 2.0 -mallille, hyväksyy arvot low, medium ja auto, ja jokainen kuva laskutetaan sen laadun mukaan, jolla se tuotetaan.

Tuotannon laadun hallinta

Nopeus / Laatu -valitsin Grok Imagine -sovelluksessa

Grok-sovelluksessa Nopeus / Laatu -valitsin tasapainottaa nopeuden ja hienostuneisuuden. Rajapinnassa tämä tasapaino vaatii kahta valintaa: mallin (Imagine 1.0 tai Imagine 2.0) ja Imagine 2.0:n osalta quality-parametrin.

quality-parametri

grok-imagine-image-2.0 hyväksyy parametrin quality sekä kuvien luontiin että muokkaamiseen. Kolme arvoa:

  • low: edullisin asetus Imagine 2.0:lle (0,04 $ per kuva listahinnoilla), ja tähän ohjataan vanhan “pro”-mallin pyynnöt;
  • medium: enemmän laskentatehoa kuvaa kohden tarkempien yksityiskohtien saavuttamiseksi; varaa tämä kuville, joissa laatu on tärkeämpää kuin kustannukset;
  • auto: oletusarvo, kun parametri jätetään pois; se tuottaa tällä hetkellä arvon low luonnissa ja medium muokkauksissa, ja kuva laskutetaan tuotetun laadun mukaan.

Hallitaksesi sekä renderöintiä että laskutusta, aseta laatu eksplisiittisesti auto-päätöksen sijaan. Kun OpenAI SDK on suunnattu xAI:n rajapintaan, parametri välitetään extra_body-kentän kautta:

# Nopea luonnos: Imagine 1.0, edullisin
brouillon = client.images.generate(
    model="grok-imagine-image",
    prompt="E-commerce website mockup, wireframe style",
)

# Tavallinen visuaalisuus: Imagine 2.0, matala laatu
courant = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt="Illustration of a mobile fitness app",
    extra_body={"quality": "low"},
)

# Lopullinen visuaalisuus: Imagine 2.0, keskitaso laatu, 2k-resoluutio
final = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt="Advertising poster for a luxury perfume, photorealistic render",
    extra_body={"quality": "medium", "resolution": "2k"},
)

Malli + quality + resoluutio -yhdistelmä

Kolme parametria, kolme vaikutusta: malli määrittää perushinnan ja käytettävissä olevat ominaisuudet, quality määrittää yksityiskohtaisen tason Imagine 2.0:lle (ja sen hinnoittelun), ja resolution määrittää kuvan tarkkuuden (oletus 1k tai 2k).

KäyttötarkoitusMalliLaatuResoluutio
Nopea prototyyppiImagine 1.0—1k
VerkkosisältöImagine 1.0—1k
Sosiaalinen mediaImagine 2.0low1k
MarkkinointivisuaalisuusImagine 2.0medium1k
Painotuote, julisteImagine 2.0medium2k

3-vaiheinen optimointityönkulku

Löydä oikea idea siellä, missä se on halpaa, hienosäädä sitä ja maksa kalleimmasta renderöinnistä vasta valitulle kuvalle.

Vaihe 1: Tutkimus

prompts_candidats = [
    "A robot barista making coffee, cartoon style",
    "A robotic arm pouring coffee, realistic style",
    "A mechanical hand holding a steaming cup, steampunk style",
]

for prompt in prompts_candidats:
    response = client.images.generate(
        model="grok-imagine-image",
        prompt=prompt,
        n=3,
    )
    # Kustannus: 3 x 0,02 $ = 0,06 $ per kehote

Vaihe 2: Hienosäätö

best_prompt = "A robotic arm pouring coffee, realistic style"

response = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt=best_prompt,
    n=4,
    extra_body={"quality": "low", "resolution": "1k"},
)
# Kustannus: 4 x 0,04 $ = 0,16 $

Vaihe 3: Viimeistely

response = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt=best_prompt + ", cinematic lighting, fine mechanical details",
    n=2,
    extra_body={"quality": "medium", "resolution": "2k"},
)
# Kustannus: 2 kuvaa nykyisellä "medium"-hinnalla

Kahden ensimmäisen vaiheen kustannus on 0,34 $ yhdeksästä luonnoksesta ja neljästä variaatiosta; vain kaksi lopullista kuvaa laskutetaan medium-hinnalla.

Automatisoi laadun valinta

Keskitä tämä valinta funktioon estääksesi sen hajoamisen koodin eri osiin. Jos hinnat muuttuvat tai malli lisätään, muutos tarvitaan vain yhteen paikkaan.

CONFIGS = {
    "prototype": {"model": "grok-imagine-image", "extra_body": {"resolution": "1k"}},
    "web": {"model": "grok-imagine-image", "extra_body": {"resolution": "1k"}},
    "social": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "low", "resolution": "1k"}},
    "marketing": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "medium", "resolution": "1k"}},
    "print": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "medium", "resolution": "2k"}},
}

def generate_smart(prompt, usage="web"):
    """Luo kuva käyttötarkoitukseen sopivilla parametreilla."""
    config = CONFIGS.get(usage, CONFIGS["web"])
    return client.images.generate(prompt=prompt, **config)

Viralliset lähteet: Image Generation — Quality · grok-imagine-image-quality Retirement on November 2, 2026 · Pricing

Keskeiset asiat

  • quality on ominainen Imagine 2.0:lle ja hyväksyy arvot low, medium ja auto (oletusarvo)
  • Kuva laskutetaan tuotetun laadun mukaan: aseta laatu eksplisiittisesti hallitaksesi laskua
  • OpenAI SDK:n kanssa quality ja resolution välitetään extra_body-kentän kautta
  • 3-vaiheinen työnkulku: tutki Imagine 1.0:lla, hienosäädä tasolla low, viimeistele tasolla medium
  • Keskitä parametrien valinta konfiguraatiofunktioon