Úprava viacerých obrázkov a referencie
Na tejto strane
Aktualizované 2. novembra 2026 — Imagine. Model
grok-imagine-image-qualitybol k 2. novembru 2026 odstránený (požiadavky sú teraz spracovávané cez Imagine 2.0 v kvalitelow): príklady teraz využívajúgrok-imagine-image(Imagine 1.0) agrok-imagine-image-2.0(Imagine 2.0, kvalitalow,mediumaleboauto). Pri používaní OpenAI SDK sa parametreaspect_ratio,resolutionaqualityodovzdávajú cezextra_body, zatiaľ čo úpravy sa riešia prostredníctvom xAI SDK alebo HTTP požiadavky.
Práca s viacerými zdrojovými obrázkmi
Jednou z hlavných výhod koncového bodu pre úpravy je možnosť poskytnúť až 5 referenčných obrázkov v jednej požiadavke. To otvára pokročilé kreatívne možnosti: kombinovanie prvkov z viacerých zdrojov, miešanie štýlov alebo vytváranie komplexných kompozícií.
Parameter images (množné číslo)
Prechod z parametra image na images mení viac než len tvar parametra: mení to, čo od modelu požadujete. Pri jednom zdroji model obrázok upravuje; pri viacerých zdrojoch musí medzi nimi rozhodovať – určiť, čo si vziať z ktorého obrázka. Rozhodovať bude vždy; otázkou len je, či tento proces nasmerujete vy, čo je témou nasledujúcej sekcie.
Upozorňujeme, že tieto dva parametre sa vzájomne vylučujú: image (jeden objekt) a images (pole) nemožno kombinovať.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Spoj postavu z prvého obrázka s "
"krajinou z druhého obrázka",
"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()
Odvolávanie sa na obrázky v texte príkazu (Prompt)
Keď poskytuješ viacero obrázkov, môžeš sa na ne v texte príkazu odvolávať jednotlivo pomocou syntaxe <IMAGE_0>, <IMAGE_1> atď. Indexovanie začína od 0.
payload = {
"model": "grok-imagine-image",
"prompt": "Umiestni produkt z <IMAGE_0> na stôl z <IMAGE_1>, "
"s okolitým osvetlením z <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>
]
}
Práve táto syntax odlišuje kontrolovanú kompozíciu od približného zmiešania. Príkaz „Spoj tieto obrázky“ necháva všetko na modeli; príkaz „umiestni produkt z <IMAGE_0> do prostredia <IMAGE_1> pri zachovaní osvetlenia z <IMAGE_1>“ neponecháva priestor na interpretáciu. Akonáhle poskytuješ viac ako jeden zdroj, explicitne sa na ne odvolávaj.
Prípady použitia s viacerými obrázkami
Prenos štýlu
Aplikuj štýl z referenčného obrázka na iný obrázok:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Reprodukuj obsah <IMAGE_0> v umeleckom štýle <IMAGE_1>",
"images": [
{"url": "https://exemple.com/photo-originale.jpg"},
{"url": "https://exemple.com/reference-style.jpg"}
]
}
Kompozícia produktu
Integruj produkt do prostredia s referenčným osvetlením:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Ofoť produkt z <IMAGE_0> umiestnený na nábytku z <IMAGE_1> "
"v miestnosti z <IMAGE_2>, konzistentné prirodzené osvetlenie",
"images": [
{"url": "https://exemple.com/produit-detouré.png"},
{"url": "https://exemple.com/meuble.jpg"},
{"url": "https://exemple.com/piece.jpg"}
]
}
Spojenie tváre a pozadia
Spoj portrét so špecifickým pozadím:
payload = {
"model": "grok-imagine-image",
"prompt": "Umiestni osobu z <IMAGE_0> pred budovu z <IMAGE_1>, "
"pri zachovaní prirodzeného osvetlenia a perspektívy",
"images": [
{"url": "https://exemple.com/portrait.jpg"},
{"url": "https://exemple.com/batiment.jpg"}
]
}
Obmedzenia a osvedčené postupy
Technický limit je 5 obrázkov na požiadavku a môžeš voľne kombinovať formáty – niektoré zdroje ako URL, iné ako Base64 – v rámci toho istého poľa. Skutočná ťažkosť však nie je v tom: spočíva v presnosti textu príkazu, ktorá musí rásť s počtom obrázkov. Pri dvoch zdrojoch často stačí „spoj postavu a prostredie“; pri piatich zdrojoch model už nedokáže uhádnuť, ktorý prvok si má vziať z ktorého obrázka. Presne tu prichádzajú na rad referencie <IMAGE_1> až <IMAGE_5>: príkaz „umiestni logo z <IMAGE_2> na tričko postavy z <IMAGE_1> v svetelnej atmosfére z <IMAGE_3>“ neponecháva žiadnu nejasnosť. Pri komplexných kompozíciách z viacerých zdrojov sa profesionálny model (grok-imagine-image-quality) oplatí: práve tu je rozdiel oproti štandardnému modelu najviditeľnejší, a to v konzistencii medzi heterogénnymi prvkami.
Praktické cvičenie
Skús skombinovať dva obrázky, ktoré máš po ruke:
payload = {
"model": "grok-imagine-image",
"prompt": "Vytvor scénu, kde objekt z <IMAGE_0> pláva na oblohe z <IMAGE_1>, "
"surrealistický štýl",
"images": [
{"url": "URL_OF_YOUR_FIRST_IMAGE"},
{"url": "URL_OF_YOUR_SECOND_IMAGE"}
],
"n": 3
}
Vygeneruj 3 variácie, aby si mohol porovnať interpretácie modelu.
Kľúčové poznatky
- Parameter
imagesprijíma až 5 zdrojových obrázkov v poli - Parametre
image(jednotné číslo) aimages(množné číslo) sa vzájomne vylučujú - Syntax
<IMAGE_0>,<IMAGE_1>ti umožňuje odvolať sa na každý obrázok v texte príkazu - Medzi prípady použitia patrí prenos štýlu, kompozícia a spájanie
- Pri práci s viacerými zdrojmi buď v texte príkazu čo najpresnejší