Muokkaus usealla kuvalla ja viittaukset
Tällä sivulla
Päivitetty 2. marraskuuta 2026 — Imagine.
grok-imagine-image-qualitypoistettiin käytöstä 2. marraskuuta 2026 alkaen (pyynnöt käsitellään nyt Imagine 2.0:lla laadullalow): esimerkit käyttävät 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, 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
imageshyväksyy jopa 5 lähdekuvaa taulukkona image(yksikkö) jaimages(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ä