Laatuparametri ja renderöinnin optimointi
Tällä sivulla
Oppitunti kirjoitettu uudelleen 2. marraskuuta 2026. Edellinen versio kuvasi
high-arvoa jaquality-parametria, jotka eivät vaikuttaneet hintaan nyt jo eläkkeelle siirtyneelle “pro”-mallille. xAI:n nykyisen dokumentaation mukaanqualityon ominainen Imagine 2.0 -mallille, hyväksyy arvotlow,mediumjaauto, ja jokainen kuva laskutetaan sen laadun mukaan, jolla se tuotetaan.
Tuotannon laadun hallinta

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ä arvonlowluonnissa jamediummuokkauksissa, 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ötarkoitus | Malli | Laatu | Resoluutio |
|---|---|---|---|
| Nopea prototyyppi | Imagine 1.0 | — | 1k |
| Verkkosisältö | Imagine 1.0 | — | 1k |
| Sosiaalinen media | Imagine 2.0 | low | 1k |
| Markkinointivisuaalisuus | Imagine 2.0 | medium | 1k |
| Painotuote, juliste | Imagine 2.0 | medium | 2k |
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
qualityon ominainen Imagine 2.0:lle ja hyväksyy arvotlow,mediumjaauto(oletusarvo)- Kuva laskutetaan tuotetun laadun mukaan: aseta laatu eksplisiittisesti hallitaksesi laskua
- OpenAI SDK:n kanssa
qualityjaresolutionvälitetäänextra_body-kentän kautta - 3-vaiheinen työnkulku: tutki Imagine 1.0:lla, hienosäädä tasolla
low, viimeistele tasollamedium - Keskitä parametrien valinta konfiguraatiofunktioon