Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Suhdeluvut, resoluutiot ja tulostusmuodot

Oppitunti 3 / 14 Päivitetty 2. marraskuuta 2026 Aloittelija
Tällä sivulla
  1. Kuvasuhteiden hallinta
  2. Käytettävissä olevat suhdeluvut
  3. Resoluutiot: 1k vs 2k
  4. Vastausmuodot
  5. Oikean yhdistelmän valinta
  6. Keskeiset asiat

Päivitetty 2. marraskuuta 2026 — Imagine. grok-imagine-image-quality on poistettu käytöstä 2. marraskuuta 2026 alkaen (sen pyynnöt käsitellään nyt Imagine 2.0:lla laadulla low): esimerkeissä käytetään nyt malleja grok-imagine-image (Imagine 1.0) ja grok-imagine-image-2.0 (Imagine 2.0, laatu low, medium tai auto). OpenAI SDK:n kanssa parametrit aspect_ratio, resolution ja quality välitetään kohdassa extra_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, resoluutio 1k, Imagine 1.0
  • Story/Reel: 9:16, resoluutio 1k, Imagine 1.0
  • Verkkobanneri: 16:9 tai 2:1, resoluutio 1k, Imagine 1.0
  • Tapahtumajuliste: 3:4, resoluutio 2k, Imagine 2.0 laadulla medium
  • Artikkelin kuvitus: 16:9, resoluutio 2k, Imagine 2.0 laadulla medium

Keskeiset asiat

  • Yli 10 eri suhdelukua saatavilla, plus auto-tila
  • Kaksi resoluutiota: 1k (nopea, verkko) ja 2k (yksityiskohtainen, painatus)
  • Kaksi vastausmuotoa: url (väliaikainen) ja b64_json (pysyvä)
  • Palautetut MIME-tyypit voivat olla PNG, JPEG tai WebP
  • Sovita suhdeluku kuvan jakelukanavaan