Uređivanje više slika i reference
Na ovoj stranici
Ažurirano 2. studenoga 2026. — Imagine.
grok-imagine-image-qualityuklonjen je od 2. studenoga 2026. (zahtjevi se sada obrađuju putem Imagine 2.0 ulowkvaliteti): primjeri sada koristegrok-imagine-image(Imagine 1.0) igrok-imagine-image-2.0(Imagine 2.0,low,mediumiliautokvaliteta). Uz OpenAI SDK,aspect_ratio,resolutioniqualityprosljeđuju se putemextra_body, dok se uređivanje obrađuje putem xAI SDK-a ili HTTP zahtjeva.
Rad s više izvornih slika
Jedna od prednosti krajnje točke za uređivanje je mogućnost pružanja do 5 referentnih slika u jednom zahtjevu. To otvara napredne kreativne mogućnosti: kombiniranje elemenata iz više izvora, stapanje stilova ili stvaranje složenih kompozicija.
Parametar images (množina)
Prijelaz s image na images mijenja više od oblika parametra: mijenja i ono što tražiš od modela. S jednim izvorom, on modificira sliku; s više njih, mora arbitrirati između njih — odlučujući što će uzeti iz svake. Arbitrirat će u svakom slučaju; jedino je pitanje hoćeš li usmjeriti taj proces, što je fokus sljedećeg odjeljka.
Imaj na umu da su ta dva parametra međusobno isključiva: image (jedan objekt) i images (niz) ne mogu se kombinirati.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Kombiniraj lik iz prve slike s "
"krajolikom iz druge slike",
"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()
Referenciranje slika u upitu (promptu)
Kada pružiš više slika, možeš ih pojedinačno referencirati u svom upitu koristeći sintaksu <IMAGE_0>, <IMAGE_1> itd. Indeks počinje od 0.
payload = {
"model": "grok-imagine-image",
"prompt": "Postavi proizvod iz <IMAGE_0> na stol iz <IMAGE_1>, "
"s ambijentalnim osvjetljenjem iz <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>
]
}
Ova sintaksa razlikuje kontroliranu kompoziciju od približnog stapanja. „Kombiniraj ove slike“ prepušta sve modelu; „postavi proizvod iz <IMAGE_0> u okruženje <IMAGE_1> zadržavajući osvjetljenje iz <IMAGE_1>“ ne ostavlja prostora za tumačenje. Čim pružiš više od jednog izvora, eksplicitno ih referenciraj.
Slučajevi uporabe s više slika
Prijenos stila
Primijeni stil referentne slike na drugu:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Reproduciraj sadržaj <IMAGE_0> u umjetničkom stilu <IMAGE_1>",
"images": [
{"url": "https://exemple.com/photo-originale.jpg"},
{"url": "https://exemple.com/reference-style.jpg"}
]
}
Kompozicija proizvoda
Integriraj proizvod u okruženje s referentnim osvjetljenjem:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Fotografiraj proizvod iz <IMAGE_0> postavljen na namještaj iz <IMAGE_1> "
"u sobi iz <IMAGE_2>, uz dosljedno prirodno osvjetljenje",
"images": [
{"url": "https://exemple.com/produit-detouré.png"},
{"url": "https://exemple.com/meuble.jpg"},
{"url": "https://exemple.com/piece.jpg"}
]
}
Spajanje lica i pozadine
Kombiniraj portret s određenom pozadinom:
payload = {
"model": "grok-imagine-image",
"prompt": "Postavi osobu iz <IMAGE_0> ispred zgrade iz <IMAGE_1>, "
"zadržavajući prirodno osvjetljenje i perspektivu",
"images": [
{"url": "https://exemple.com/portrait.jpg"},
{"url": "https://exemple.com/batiment.jpg"}
]
}
Ograničenja i najbolje prakse
Tehničko ograničenje je 5 slika po zahtjevu, a u istom nizu možeš slobodno miješati formate — neki izvori kao URL-ovi, drugi kao Base64. Prava poteškoća nije u tome: leži u preciznosti upita, koja mora rasti s brojem slika. S dva izvora, „kombiniraj lik i okruženje“ često je dovoljno; s pet, model više ne može pogoditi koji element uzeti iz koje slike, a upravo je to uloga referenci od <IMAGE_1> do <IMAGE_5>: „postavi logo iz <IMAGE_2> na majicu lika iz <IMAGE_1>, u ambijentu osvjetljenja iz <IMAGE_3>“ ne ostavlja nikakvu dvosmislenost. Za složene kompozicije s više izvora, pro model (grok-imagine-image-quality) opravdava svoju dodatnu cijenu: upravo je ondje jaz sa standardnim modelom najvidljiviji, u dosljednosti između heterogenih elemenata.
Praktična vježba
Pokušaj kombinirati dvije slike koje imaš pri ruci:
payload = {
"model": "grok-imagine-image",
"prompt": "Stvori scenu u kojoj objekt iz <IMAGE_0> lebdi u nebu iz <IMAGE_1>, "
"u nadrealističkom stilu",
"images": [
{"url": "URL_OF_YOUR_FIRST_IMAGE"},
{"url": "URL_OF_YOUR_SECOND_IMAGE"}
],
"n": 3
}
Generiraj 3 varijacije kako bi usporedio interpretacije modela.
Ključne točke
- Parametar
imagesprihvaća do 5 izvornih slika u nizu image(jednina) iimages(množina) međusobno su isključivi- Sintaksa
<IMAGE_0>,<IMAGE_1>omogućuje referenciranje svake slike u upitu - Slučajevi uporabe uključuju prijenos stila, kompoziciju i spajanje
- Budi precizan u svom upitu kada koristiš više izvora