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

Suhted, eraldusvõimed ja väljundvormingud

Õppetund 3 / 14 Värskendatud 2. november 2026 Algajatele
Sellel lehel
  1. Oma pildi mõõtmete valdamine
  2. Saadaval olevad kuvasuhted
  3. Eraldusvõimed: 1k vs 2k
  4. Vastuse vormingud
  5. Õige kombinatsiooni valimine
  6. 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 edaspidi mudeleid grok-imagine-image (Imagine 1.0) ja grok-imagine-image-2.0 (Imagine 2.0, kvaliteediga low, medium või auto). OpenAI SDK kasutamisel edastatakse parameetrid aspect_ratio, resolution ja quality väljal extra_body, samas kui piltide muutmine toimub xAI SDK või HTTP-päringu kaudu.

Oma pildi mõõtmete valdamine

Valitud suhe ja eraldusvõime määravad otseselt sinu genereeritud piltide välimuse ja kasutusvõimalused. Grok Imagine API pakub märkimisväärset paindlikkust, pakkudes arvukalt eelmääratud suhteid ja kahte eraldusvõime taset.

Saadaval olevad kuvasuhted

Vali suhe vastavalt sihtkohale ja tee see valik enne genereerimist. Ruutpildi järelkõnelemine panoraamseks bänneriks lõikab sisse kompositsiooni, mille mudel ehitas ruudu jaoks: subjekt jääb keskelt välja, marginaalid kaovad. Õiges formaadis genereerimine maksab sama palju, kuid annab sulle pildi, mis on loodud just sellele proportsioonile.

Suhe Orientatsioon Tüüpiline kasutus
1:1 Ruut Profiilipildid, ikoonid, Instagram
16:9 Lai maastik Esitlused, bännerid, video
9:16 Püstine portree Lood, Reels, TikTok
4:3 Klassikaline maastik Traditsioonilised fotod, dokumendid
3:4 Portree Plakatid, raamatukaaned
3:2 / 2:3 Standardfoto Fototrükid, postkaardid
2:1 / 1:2 Ülilai / ülipüstine Veebibännerid, panoraamid
auto Automaatne Mudel valib optimaalse suhte

Lisaks on saadaval ka erisuhted spetsiifiliste juhtumite jaoks, nagu nutitelefonide ekraanid: 9:19.5, 19.5:9, 9:20 ja 20:9.

Eraldusvõimed: 1k vs 2k

Valikute 1k ja 2k vahel ei ole küsimus selles, „kumb on parem“, vaid „kus seda pilti vaadatakse“. Ekraanil on erinevus enamiku veebikasutuste puhul nähtamatu ja 2k tähendab vaid pikemat genereerimisaega. Trükiste puhul muutub see aga kriitiliseks, kus pikslite arv sentimeetri kohta määrab otseselt tajutava teravuse.

  • 1k: Standardne eraldusvõime, sobib enamiku veebikasutuste jaoks. Kiirem genereerimisaeg.
  • 2k: Kõrge eraldusvõime, ideaalne trükiste või detailirohkete visuaalide jaoks.
# Standardne eraldusvõime veebi jaoks
response_web = client.images.generate(
    model="grok-imagine-image",
    prompt="Neoon-stiilis mobiilirakenduse ikoon",
    extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)

# Kõrge eraldusvõime trüki jaoks
response_print = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt="Art deco kontserdiplakat elegantse tüpograafiaga",
    extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)

Vastuse vormingud

Parameeter response_format määrab, kuidas pilt sulle tagastatakse:

Ajutine URL (vaikimisi)

response = client.images.generate(
    model="grok-imagine-image",
    prompt="Astronaut-kass",
    response_format="url"
)
# response.data[0].url → Ajutine URL, laadi kiiresti alla

Base64 JSON

import base64

response = client.images.generate(
    model="grok-imagine-image",
    prompt="Astronaut-kass",
    response_format="b64_json"
)

image_bytes = base64.b64decode(response.data[0].b64_json)
with open("astronaut_cat.png", "wb") as f:
    f.write(image_bytes)

Oluline sõna on ajutine: tagastatud URL aegub. Rakendus, mis salvestab selle andmebaasi ja kuvab nädalaid hiljem, seisab silmitsi katkiste piltidega, sageli alles pärast kasutuselevõttu. Toimib kaks võimalust: laadi pilt URL-ilt kohe alla või küsi see otse Base64-formaadis – mõlemal juhul peab pilt lõpuks jõudma sinu enda salvestusruumi.

Õige kombinatsiooni valimine

Iga kasutusjuhu jaoks on siin soovitatud kombinatsioonid:

  • Instagrami postitus: 1:1, eraldusvõime 1k, Imagine 1.0
  • Lugu/Reel: 9:16, eraldusvõime 1k, Imagine 1.0
  • Veebibänner: 16:9 või 2:1, eraldusvõime 1k, Imagine 1.0
  • Ürituse plakat: 3:4, eraldusvõime 2k, Imagine 2.0 kvaliteediga medium
  • Artikli illustratsioon: 16:9, eraldusvõime 2k, Imagine 2.0 kvaliteediga medium

Peamised punktid

  • Saadaval on üle 10 kuvasuhte, lisaks auto-režiim
  • Kaks eraldusvõimet: 1k (kiire, veeb) ja 2k (detailne, trükk)
  • Kaks vastusevormingut: url (ajutine) ja b64_json (püsiv)
  • Tagastatavad MIME-tüübid võivad olla PNG, JPEG või WebP
  • Kohanda suhe vastavalt oma pildi levikanalile