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

Muokkaus usealla kuvalla ja viittaukset

Oppitunti 7 / 14 Päivitetty 2. marraskuuta 2026 Aloittelija
Tällä sivulla
  1. Työskentely usean lähdekuvan kanssa
  2. Parametri images (monikko)
  3. Kuvien viittaaminen kehotteessa
  4. Käyttötapauksia useilla kuvilla
  5. Rajat ja parhaat käytännöt
  6. Käytännön harjoitus
  7. Keskeiset asiat

Päivitetty 2. marraskuuta 2026 — Imagine. grok-imagine-image-quality poistettiin käytöstä 2. marraskuuta 2026 alkaen (pyynnöt käsitellään nyt Imagine 2.0:lla laadulla low): esimerkit käyttävät 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, ja muokkaus hoidetaan xAI SDK:n tai HTTP-pyynnön kautta.

Työskentely usean lähdekuvan kanssa

Yksi muokkauspäätepisteen vahvuuksista on mahdollisuus toimittaa jopa 5 viitekuvaa yhdessä pyynnössä. Tämä avaa edistyneitä luovia mahdollisuuksia: elementtien yhdistäminen useista lähteistä, tyylien sulauttaminen tai monimutkaisten sommitelmien luominen.

Parametri images (monikko)

Siirtyminen parametrista image parametriin images muuttaa enemmän kuin vain parametrin rakennetta: se muuttaa sitä, mitä pyydät mallia tekemään. Yhden lähteen kanssa se muokkaa kuvaa; usean kanssa sen täytyy tehdä päätöksiä niiden välillä – päättää, mitä ottaa kustakin. Se tekee päätöksiä joka tapauksessa; ainoa kysymys on, ohjaatko tätä prosessia, mikä on seuraavan osion aihe.

Huomaa, että nämä kaksi parametria ovat toisensa poissulkevia: image (yksittäinen objekti) ja images (taulukko) eivät voi esiintyä yhdessä.

import requests
import os

headers = {
    "Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
    "Content-Type": "application/json"
}

payload = {
    "model": "grok-imagine-image",
    "prompt": "Yhdistä ensimmäisen kuvan hahmo "
              "toisen kuvan maisemaan",
    "images": [
        {"url": "https://exemple.com/personnage.jpg"},
        {"url": "https://exemple.com/paysage.jpg"}
    ]
}

response = requests.post(
    "https://api.x.ai/v1/images/edits",
    headers=headers,
    json=payload
).json()

Kuvien viittaaminen kehotteessa

Kun toimitat useita kuvia, voit viitata niihin yksitellen kehotteessasi käyttämällä syntaksia <IMAGE_0>, <IMAGE_1> jne. Indeksointi alkaa nollasta.

payload = {
    "model": "grok-imagine-image",
    "prompt": "Sijoita tuote kuvasta <IMAGE_0> pöydälle kuvasta <IMAGE_1> "
              "käyttäen valaistusta kuvasta <IMAGE_2>",
    "images": [
        {"url": "https://exemple.com/produit.jpg"},      # <IMAGE_0>
        {"url": "https://exemple.com/table.jpg"},         # <IMAGE_1>
        {"url": "https://exemple.com/ambiance.jpg"}       # <IMAGE_2>
    ]
}

Tämä syntaksi erottaa hallitun sommitelman likimääräisestä sekoituksesta. Kehote “yhdistä nämä kuvat” jättää kaiken mallin päätettäväksi; kehotteella “sijoita tuote kuvasta <IMAGE_0> ympäristöön kuvasta <IMAGE_1> säilyttäen valaistus kuvasta <IMAGE_1>” ei jää tilaa tulkinnoille. Heti kun toimitat enemmän kuin yhden lähteen, viittaa niihin eksplisiittisesti.

Käyttötapauksia useilla kuvilla

Tyylinsiirto

Sovuta viitekuvan tyyli toiseen kuvaan:

payload = {
    "model": "grok-imagine-image-2.0",
    "prompt": "Toista kuvan <IMAGE_0> sisältö käyttäen kuvan <IMAGE_1> taiteellista tyyliä",
    "images": [
        {"url": "https://exemple.com/photo-originale.jpg"},
        {"url": "https://exemple.com/reference-style.jpg"}
    ]
}

Tuotesommitelma

Integroi tuote ympäristöön käyttäen viitevalaistusta:

payload = {
    "model": "grok-imagine-image-2.0",
    "prompt": "Valokuvaa tuote kuvasta <IMAGE_0> sijoitettuna huonekalulle kuvasta <IMAGE_1> "
              "huoneessa kuvasta <IMAGE_2>, luonnollinen valaistus johdonmukainen",
    "images": [
        {"url": "https://exemple.com/produit-detouré.png"},
        {"url": "https://exemple.com/meuble.jpg"},
        {"url": "https://exemple.com/piece.jpg"}
    ]
}

Kasvojen ja taustan sulauttaminen

Yhdistä muotokuva tiettyyn taustaan:

payload = {
    "model": "grok-imagine-image",
    "prompt": "Sijoita henkilö kuvasta <IMAGE_0> rakennuksen eteen kuvasta <IMAGE_1> "
              "säilyttäen luonnollinen valaistus ja perspektiivi",
    "images": [
        {"url": "https://exemple.com/portrait.jpg"},
        {"url": "https://exemple.com/batiment.jpg"}
    ]
}

Rajat ja parhaat käytännöt

Tekninen raja on 5 kuvaa pyyntöä kohden, ja voit vapaasti sekoittaa formaatteja – jotkin lähteet URL-osoitteina, toiset Base64-muodossa – samassa taulukossa. Todellinen haaste ei ole tässä: se piilee kehotteen tarkkuudessa, jonka täytyy kasvaa kuvien määrän myötä. Kahden lähteen kanssa “yhdistä hahmo ja ympäristö” usein riittää; viiden lähteen kanssa malli ei enää voi arvata, minkä elementin se ottaa mistäkin kuvasta, ja juuri tähän <IMAGE_1>–<IMAGE_5>-viittaukset on tarkoitettu: “sijoita logo kuvasta <IMAGE_2> hahmon t-paitaan kuvasta <IMAGE_1> valaistusilmapiirissä kuvasta <IMAGE_3>” ei jätä tilaa epäselvyydelle. Monimutkaisissa monilähteisissä sommitelmissa pro-malli (grok-imagine-image-quality) perustelee lisäkustannuksensa: juuri tässä ero tavalliseen malliin on näkyvin, erityisesti heterogeenisten elementtien johdonmukaisuudessa.

Käytännön harjoitus

Kokeile yhdistää kaksi käsilläsi olevaa kuvaa:

payload = {
    "model": "grok-imagine-image",
    "prompt": "Luo kohtaus, jossa esine kuvasta <IMAGE_0> leijuu taivaalla kuvasta <IMAGE_1> "
              "surrealistisella tyylillä",
    "images": [
        {"url": "URL_OF_YOUR_FIRST_IMAGE"},
        {"url": "URL_OF_YOUR_SECOND_IMAGE"}
    ],
    "n": 3
}

Generoi 3 variaatiota vertaillaksesi mallin tulkintoja.

Keskeiset asiat

  • Parametri images hyväksyy jopa 5 lähdekuvaa taulukkona
  • image (yksikkö) ja images (monikko) ovat toisensa poissulkevia
  • Syntaksi <IMAGE_0>, <IMAGE_1> mahdollistaa kunkin kuvan viittaamisen kehotteessa
  • Käyttötapauksiin kuuluvat tyylinsiirto, sommitelma ja sulauttaminen
  • Ole tarkka kehotteessasi, kun käytät useita lähteitä