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

grok-imagine-image: Kuvien generointi

Oppitunti 5 / 14 Päivitetty 2. marraskuuta 2026 Aloittelija
Tällä sivulla
  1. xAI:n kuvien generointi
  2. Kaksi mallia
  3. Mallien vertailu
  4. API-päätepiste
  5. Batch-API kuville
  6. Parhaat käytännöt kuvakehotteille
  7. 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 mallilla Imagine Image 2.0 (grok-imagine-image-2.0, 0,04 $ per kuva) laadulla low. Korvaa tunniste esimerkeissäsi ja aseta haluamasi laatu; grok-imagine-image (versio 1.0) ei muutu. Imagine Image 2.0 hyväksyy jopa viisi referenssikuvaa sekä laatuasetuksen auto, joka on nyt oletusarvo.

xAI:n kuvien generointi

xAI on tarjonnut omia kuvien generointimallejaan Grok Imagine -brändin alla maaliskuusta 2025 lähtien. 2. marraskuuta 2026 tilanne on seuraava: valikoimaan kuuluu kaksi mallia, Imagine 1.0, joka on edullinen ja suunniteltu suurille määrille, sekä Imagine 2.0, joka on kalliimpi ja tarjoaa laatuasetuksia. Tämän kurssin aiemmissa versioissa mainittu “Pro”-malli grok-imagine-image-quality on poistettu käytöstä 2. marraskuuta 2026 alkaen: sen pyynnöt ohjataan nyt Imagine 2.0 -mallille laadulla low.

Jos tarvitset visuaalista sisältöä sovelluksiisi – kuten kuvituksia, mockupeja, markkinointimateriaaleja tai luovia assetteja – Grok Imagine -mallit integroituvat suoraan xAI:n APIin kuvakohtaisella laskutuksella.

Kaksi mallia

grok-imagine-image (Imagine 1.0)

Suurille määrille suunniteltu malli. Hinnalla 0,02 $ per kuva voit tuottaa visuaalista sisältöä laajassa mittakaavassa budjettia rasittamatta; virallinen dokumentaatio ilmoittaa nopeudeksi 6 pyyntöä sekunnissa. Käytä sitä prototyyppeihin, luoviin variaatioihin ja automatisoituun sisältöön.

grok-imagine-image-2.0 (Imagine 2.0)

Malli lopullisiin visuaalisiin tuotoksiin, hinta 0,04 $ per kuva laadulla low. Se hyväksyy parametrin quality (low, medium tarkempaan yksityiskohtaisuuteen tai auto, joka on oletusarvo), ja jokainen kuva laskutetaan toteutuneen laadun mukaan. Se hyväksyy myös jopa viisi lähdekuvaa muokkausta varten sekä kuvasuhteet 21:9 ja 5:2; virallinen dokumentaatio ilmoittaa nopeudeksi 6 pyyntöä sekunnissa.

Mallien vertailu

OminaisuusImagine 1.0Imagine 2.0
Mallin IDgrok-imagine-imagegrok-imagine-image-2.0
Hinta per kuva0,02 $0,04 $ laadulla low; medium hinnaston mukaan
Läpimeno (viralliset specit)6 pyyntöä sekunnissa6 pyyntöä sekunnissa
LaatuasetusEilow, medium, auto
KäyttökohteetSuuret määrät, prototypointiJulkaisu, markkinointi, muokkaus

API-päätepiste

Kuvien generointi käyttää päätepistettä /v1/images/generations. Tässä on tyypillisen kutsun rakenne:

response = client.images.generate(
    model="grok-imagine-image",
    prompt="A mountainous landscape at sunset, oil painting style",
    n=1,
    extra_body={"aspect_ratio": "1:1"},
)
image_url = response.data[0].url

Voit määrittää erilaisia resoluutioita ja kuvasuhteita tarpeidesi mukaan: neliö (1024x1024), maisema (1536x1024), pysty (1024x1536) ja muut yhdistelmät.

Batch-API kuville

Maaliskuusta 2026 lähtien Batch-API on tukenut kuvien generointia. Tämä mahdollistaa kehoteerien (prompts) eräajon ja tulosten hakemisen asynkronisesti. Batch-APIn kautta generoidut kuvat laskutetaan normaalihinnalla – toisin kuin teksti-tokenit, niille ei myönnetä 50 %:n alennusta.

Batch on erityisen hyödyllinen kuvakirjastojen luomisessa: yhden konseptin variaatiot, teemasarjat tai verkkosivustolle tarkoitetut kuvituskokoelmat.

Parhaat käytännöt kuvakehotteille

Generoitujen kuvien laatu riippuu voimakkaasti kehotteen (prompt) laadusta. Muutama vinkki:

  • Ole tarkka taiteellisesta tyylistä: “watercolor”, “macro photography”, “vector illustration”
  • Kuvaile sommittelua: etuala, tausta, katselukulma, valaistus
  • Määritä hallitsevat värit, jos sinulla on brändiohjeistuksen rajoitteita
  • Ilmoita odotettu yksityiskohtaisuustaso: minimalistinen, yksityiskohtainen, hyperrealistinen

Hinnoittelu 5. elokuuta 2026 tilanteen mukaan — hinnat muuttuvat säännöllisesti: ennen budjetin laskemista tarkista ajantasainen hinnasto xAI:n viralliselta mallit ja hinnoittelu -sivulta.

Keskeiset asiat

  • Kaksi mallia: Imagine 1.0 hintaan 0,02 $/kuva (määrä) ja Imagine 2.0 hintaan 0,04 $/kuva (laatu)
  • Molemmat mallit tukevat 6 pyyntöä sekunnissa
  • Päätepiste on /v1/images/generations
  • Batch-API on ollut saatavilla eräajoon maaliskuusta 2026 lähtien
  • Batch-kuvat eivät saa 50 %:n alennusta
  • Kehotteen laatu on ratkaisevan tärkeä hyvien tulosten saavuttamiseksi