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

Parameeter quality ja renderdamise optimeerimine

Õppetund 12 / 14 Värskendatud 2. november 2026 Algajatele
Sellel lehel
  1. Generatsiooni kvaliteedi juhtimine
  2. Parameeter quality
  3. Mudeli, kvaliteedi ja resolutsiooni kombinatsioon
  4. 3-etapiline optimeerimise töövoog
  5. Automatiseeri kvaliteedi valik
  6. Peamised punktid

Õppetund kirjutati 2. novembril 2026 ümber. Eelmine versioon kirjeldas väärtust high ja parameetrit quality, mis ei mõjutanud hinda ning kuulusid nüüdseks suletud “pro” mudelile. Vastavalt xAI praegusele dokumentatsioonile on quality spetsiifiline ainult Imagine 2.0-le, aktsepteerib väärtusi low, medium ja auto ning iga pildi eest arvutatakse tasu selle kvaliteedi järgi, milles see serveeriti.

Generatsiooni kvaliteedi juhtimine

Kiiruse / kvaliteedi valik Grok Imagine rakenduses

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äärtust low ja redigeerimisel medium; 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).

KasutusjuhtumMudelKvaliteetResolutsioon
Kiire prototüüpImagine 1.0—1k
VeebisisuImagine 1.0—1k
SotsiaalmeediaImagine 2.0low1k
TurundusvisuaalImagine 2.0medium1k
Trükis, plakatImagine 2.0medium2k

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

  • quality on spetsiifiline ainult Imagine 2.0-le ja aktsepteerib väärtusi low, medium ja auto (vaikimisi)
  • Pildi eest arvutatakse tasu serveeritud kvaliteedi järgi: määra kvaliteet selgelt, et kontrollida arvet
  • OpenAI SDK kasutamisel edastatakse quality ja resolution parameetri extra_body kaudu
  • 3-etapiline töövoog: uuri kasutades Imagine 1.0, viimistle režiimis low, lõpeta režiimis medium
  • Koonalda parameetrite valik konfiguratsioonifunktsiooni