Suhdeluvut, resoluutiot ja tulostusmuodot
Tällä sivulla
Päivitetty 2. marraskuuta 2026 — Imagine.
grok-imagine-image-qualityon poistettu käytöstä 2. marraskuuta 2026 alkaen (sen pyynnöt käsitellään nyt Imagine 2.0:lla laadullalow): esimerkeissä käytetään nyt mallejagrok-imagine-image(Imagine 1.0) jagrok-imagine-image-2.0(Imagine 2.0, laatulow,mediumtaiauto). OpenAI SDK:n kanssa parametritaspect_ratio,resolutionjaqualityvälitetään kohdassaextra_body, kun taas kuvan muokkaus tapahtuu xAI SDK:n tai HTTP-pyynnön kautta.
Kuvasuhteiden hallinta
Valitsemasi suhdeluku ja resoluutio määräävät suoraan luotujen kuvien ulkoasun ja käyttötarkoituksen. Grok Imagine API tarjoaa huomattavaa joustavuutta lukuisilla esiasetetuilla suhteilla ja kahdella resolutiotasolla.
Käytettävissä olevat suhdeluvut
Valitse suhdeluku kohteen perusteella, ja tee valinta ennen kuvan generointia. Neliökuvan leikkaaminen panoramamaiseksi banneriksi jälkikäteen tuhoaa mallin neliölle rakentaman sommittelun: kohde siirtyy epäkeskeiseksi ja marginaalit katoavat. Oikean muodon käyttäminen suoraan generoinnissa maksaa saman verran, mutta antaa kuvan, joka on suunniteltu nimenomaan niihin mittasuhteisiin.
| Suhde | Suunta | Tyypillinen käyttö |
|---|---|---|
| 1:1 | Neliö | Profiilikuvat, ikonit, Instagram |
| 16:9 | Leveä maisema | Esitykset, bannerit, video |
| 9:16 | Pysty muotokuva | Storiet, Reels, TikTok |
| 4:3 | Klassinen maisema | Perinteiset valokuvat, dokumentit |
| 3:4 | Muotokuva | Julisteet, kansikuvat |
| 3:2 / 2:3 | Vakiovalokuva | Valokuvatulosteet, postikortit |
| 2:1 / 1:2 | Erittäin leveä / erittäin pysty | Verkkobannerit, panoramat |
| auto | Automaattinen | Malli valitsee optimaalisen suhteen |
Lisäsuhdelukuja on saatavilla erityistapauksiin, kuten älypuhelimen näytöille: 9:19.5, 19.5:9, 9:20 ja 20:9.
Resoluutiot: 1k vs 2k
Valinta 1k:n ja 2k:n välillä ei ole kysymys siitä, “kumpi on paras”, vaan “missä kuvaa tullaan katsomaan”. Näytöllä ero on näkymätön valtaosassa verkkokäyttöä, ja 2k vain kasvattaa generointiaikaa. Se muuttuu kuitenkin kriittiseksi painatuksessa, jossa pikselien määrä senttimetriä kohti määrää suoraan havaitun terävyyden.
1k: Vakioresoluutio, sopii useimpiin verkkokäyttötapauksiin. Nopeampi generointiaika.2k: Korkea resoluutio, ihanteellinen painatuksiin tai visuaalisuuksiin, jotka vaativat paljon yksityiskohtia.
# Vakioresoluutio verkkoon
response_web = client.images.generate(
model="grok-imagine-image",
prompt="Neon-tyylinen mobiilisovellusikoni",
extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)
# Korkea resoluutio painatukseen
response_print = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Art deco -konserttijuliste elegantilla typografialla",
extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)
Vastausmuodot
Parametri response_format määrittää, miten kuva palautetaan sinulle:
Väliaikainen URL (oletus)
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronauttikissa",
response_format="url"
)
# response.data[0].url → Väliaikainen URL, lataa nopeasti
Base64 JSON
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronauttikissa",
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)
Tärkein sana on väliaikainen: palautettu URL vanhentuu. Sovellus, joka tallentaa sen tietokantaan ja näyttää kuvan viikkoja myöhemmin, kohtaa rikkinäisiä kuvia, usein kauan käyttöönoton jälkeen. Toimivia vaihtoehtoja on kaksi: lataa kuva URL-osoitteesta välittömästi tai pyydä se suoraan Base64-muodossa – kummassakin tapauksessa kuvan on päädyttävä omaan tallennustilaasi.
Oikean yhdistelmän valinta
Tässä ovat suositellut yhdistelmät eri käyttötarkoituksiin:
- Instagram-julkaisu:
1:1, resoluutio1k, Imagine 1.0 - Story/Reel:
9:16, resoluutio1k, Imagine 1.0 - Verkkobanneri:
16:9tai2:1, resoluutio1k, Imagine 1.0 - Tapahtumajuliste:
3:4, resoluutio2k, Imagine 2.0 laadullamedium - Artikkelin kuvitus:
16:9, resoluutio2k, Imagine 2.0 laadullamedium
Keskeiset asiat
- Yli 10 eri suhdelukua saatavilla, plus
auto-tila - Kaksi resoluutiota:
1k(nopea, verkko) ja2k(yksityiskohtainen, painatus) - Kaksi vastausmuotoa:
url(väliaikainen) jab64_json(pysyvä) - Palautetut MIME-tyypit voivat olla PNG, JPEG tai WebP
- Sovita suhdeluku kuvan jakelukanavaan