Parameeter quality ja renderdamise optimeerimine
Sellel lehel
Õppetund kirjutati 2. novembril 2026 ümber. Eelmine versioon kirjeldas väärtust
highja parameetritquality, mis ei mõjutanud hinda ning kuulusid nüüdseks suletud “pro” mudelile. Vastavalt xAI praegusele dokumentatsioonile onqualityspetsiifiline ainult Imagine 2.0-le, aktsepteerib väärtusilow,mediumjaautoning iga pildi eest arvutatakse tasu selle kvaliteedi järgi, milles see serveeriti.
Generatsiooni kvaliteedi juhtimine

Grok rakenduses tasakaalustab Kiirus / Kvaliteet (Speed / Quality) valik kiirust ja peensust. API puhul sõltub see tasakaal kahest valikust: mudel (Imagine 1.0 või Imagine 2.0) ja Imagine 2.0 puhul parameeter quality.
Parameeter quality
quality on toetatud mudeli grok-imagine-image-2.0 poolt nii generatsiooni kui ka redigeerimise korral. Kolm võimalikku väärtust:
low: Imagine 2.0 odavaim seadistus (loetletud hindade põhjal 0,04 $ pildi kohta); siia suunatakse ka vanalt “pro” mudelilt tulevaid päringuid;medium: rohkem arvutusvõimsust pildi kohta peenemate detailide saavutamiseks; reserveeri piltidele, kus kvaliteet on olulisem kui kulud;auto: vaikimisi väärtus, kui parameeter on jätmata; praegu serveerib see generatsiooni puhul väärtustlowja redigeerimiselmedium; pildi eest arvutatakse tasu serveeritud kvaliteedi järgi.
Et kontrollida nii renderdamist kui ka arvet, määra kvaliteet selgelt, selle asemel et lasta auto otsustada. Kui kasutad OpenAI SDK-d, mis on suunatud xAI API-le, edastatakse see parameetri extra_body kaudu:
# Kiire mustand: Imagine 1.0, odavaim variant
brouillon = client.images.generate(
model="grok-imagine-image",
prompt="E-commerce website mockup, wireframe style",
)
# Tavaline visuaal: Imagine 2.0, madal kvaliteet
courant = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Illustration of a mobile fitness app",
extra_body={"quality": "low"},
)
# Lõplik visuaal: Imagine 2.0, keskmine kvaliteet, 2k resolutsioon
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"},
)
Mudeli, kvaliteedi ja resolutsiooni kombinatsioon
Kolm parameetrit, kolm mõju: mudel määrab baashinna ja saadaolevad funktsioonid, quality määrab Imagine 2.0 detailitase (ja selle hinna), resolution määrab pildi eraldusvõime (vaikimisi 1k või 2k).
| Kasutusjuhtum | Mudel | Kvaliteet | Resolutsioon |
|---|---|---|---|
| Kiire prototüüp | Imagine 1.0 | — | 1k |
| Veebisisu | Imagine 1.0 | — | 1k |
| Sotsiaalmeedia | Imagine 2.0 | low | 1k |
| Turundusvisuaal | Imagine 2.0 | medium | 1k |
| Trükis, plakat | Imagine 2.0 | medium | 2k |
3-etapiline optimeerimise töövoog
Leia õige idee seal, kus see on odav, viimistle seda ja maksa kõige kallima renderduse eest ainult valitud pildi puhul.
1. etapp: Uuri
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,
)
# Kulud: 3 x 0,02 $ = 0,06 $ prompti kohta
2. etapp: Viimistle
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"},
)
# Kulud: 4 x 0,04 $ = 0,16 $
3. etapp: Lõpeta
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"},
)
# Kulud: 2 pilti jooksva "medium" hinna järgi
Kahe esimese etapi kogukulu on 0,34 $ üheksa mustandi ja nelja variandi eest; ainult kahe lõpliku pildi eest arvutatakse tasu medium hinnaga.
Automatiseeri kvaliteedi valik
Koonalda see valik funktsiooni, et vältida selle hajumist koodis. Kui hinnad muutuvad või lisandub uus mudel, tuleb muudatus teha ainult ühes kohas.
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"):
"""Genereeri pilt kasutusjuhtumile sobivate parameetritega."""
config = CONFIGS.get(usage, CONFIGS["web"])
return client.images.generate(prompt=prompt, **config)
Ametlikud allikad: Image Generation — Quality · grok-imagine-image-quality Retirement on November 2, 2026 · Pricing
Peamised punktid
qualityon spetsiifiline ainult Imagine 2.0-le ja aktsepteerib väärtusilow,mediumjaauto(vaikimisi)- Pildi eest arvutatakse tasu serveeritud kvaliteedi järgi: määra kvaliteet selgelt, et kontrollida arvet
- OpenAI SDK kasutamisel edastatakse
qualityjaresolutionparameetriextra_bodykaudu - 3-etapiline töövoog: uuri kasutades Imagine 1.0, viimistle režiimis
low, lõpeta režiimismedium - Koonalda parameetrite valik konfiguratsioonifunktsiooni