Suhted, eraldusvõimed ja väljundvormingud
Sellel lehel
Uuendatud 2. novembril 2026 — Imagine.
grok-imagine-image-qualityeemaldati 2. novembril 2026 (selle päringuid teenindab nüüd Imagine 2.0 madalas kvaliteedis): näited kasutavad edaspidi mudeleidgrok-imagine-image(Imagine 1.0) jagrok-imagine-image-2.0(Imagine 2.0, kvaliteedigalow,mediumvõiauto). OpenAI SDK kasutamisel edastatakse parameetridaspect_ratio,resolutionjaqualityväljalextra_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õime1k, Imagine 1.0 - Lugu/Reel:
9:16, eraldusvõime1k, Imagine 1.0 - Veebibänner:
16:9või2:1, eraldusvõime1k, Imagine 1.0 - Ürituse plakat:
3:4, eraldusvõime2k, Imagine 2.0 kvaliteedigamedium - Artikli illustratsioon:
16:9, eraldusvõime2k, Imagine 2.0 kvaliteedigamedium
Peamised punktid
- Saadaval on üle 10 kuvasuhte, lisaks
auto-režiim - Kaks eraldusvõimet:
1k(kiire, veeb) ja2k(detailne, trükk) - Kaks vastusevormingut:
url(ajutine) jab64_json(püsiv) - Tagastatavad MIME-tüübid võivad olla PNG, JPEG või WebP
- Kohanda suhe vastavalt oma pildi levikanalile