Úpravy více obrázků a reference
Na této stránce
Aktualizováno 2. listopadu 2026 — Imagine. Model
grok-imagine-image-qualitybyl k 2. listopadu 2026 odstraněn (požadavky jsou nyní zpracovávány modelem Imagine 2.0 v kvalitělow): příklady nyní používajígrok-imagine-image(Imagine 1.0) agrok-imagine-image-2.0(Imagine 2.0, kvalitalow,mediumneboauto). Při použití OpenAI SDK se parametryaspect_ratio,resolutionaqualitypředávají prostřednictvímextra_bodya úpravy se řeší přes xAI SDK nebo HTTP požadavek.
Práce s více zdrojovými obrázky
Jednou ze silných stránek koncového bodu pro úpravy je možnost poskytnout v jediném požadavku až 5 referenčních obrázků. To otevírá pokročilé kreativní možnosti: kombinování prvků z více zdrojů, prolínání stylů nebo vytváření složitých kompozic.
Parametr images (množné číslo)
Přechod z image na images mění více než jen tvar parametru: mění to, co od modelu požadujete. S jedním zdrojem obrázek upravuje; s více zdroji musí mezi nimi rozhodovat – určovat, co si vzít z kterého. Rozhodovat bude tak či onak; otázkou pouze je, zda tento proces nasměrujete ty sám, což je tématem následující sekce.
Měj na paměti, že tyto dva parametry se vzájemně vylučují: image (jediný objekt) a images (pole) nelze kombinovat.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Combine the character from the first image with "
"the landscape from the second image",
"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()
Odkazování na obrázky v promptu
Když poskytneš více obrázků, můžeš se na ně v promptu odkazovat jednotlivě pomocí syntaxe <IMAGE_0>, <IMAGE_1> atd. Indexování začíná od 0.
payload = {
"model": "grok-imagine-image",
"prompt": "Place the product from <IMAGE_0> on the table from <IMAGE_1>, "
"with the ambient lighting from <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ávě tato syntaxe odlišuje řízenou kompozici od přibližného smíchání. Příkaz „kombinuj tyto obrázky“ nechává vše na modelu; zatímco „umísti produkt z <IMAGE_0> do prostředí <IMAGE_1> při zachování osvětlení z <IMAGE_1>“ nenechává prostor pro interpretaci. Jakmile poskytneš více než jeden zdroj, explicitně se na ně odkazuj.
Příklady využití s více obrázky
Přenos stylu
Aplikuj styl referenčního obrázku na jiný:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Reproduce the content of <IMAGE_0> in the artistic style of <IMAGE_1>",
"images": [
{"url": "https://exemple.com/photo-originale.jpg"},
{"url": "https://exemple.com/reference-style.jpg"}
]
}
Produktová kompozice
Integruj produkt do prostředí s referenčním osvětlením:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Photograph the product from <IMAGE_0> placed on the furniture from <IMAGE_1> "
"in the room from <IMAGE_2>, consistent natural lighting",
"images": [
{"url": "https://exemple.com/produit-detouré.png"},
{"url": "https://exemple.com/meuble.jpg"},
{"url": "https://exemple.com/piece.jpg"}
]
}
Spojení obličeje a pozadí
Zkombinuj portrét s konkrétním pozadím:
payload = {
"model": "grok-imagine-image",
"prompt": "Place the person from <IMAGE_0> in front of the building from <IMAGE_1>, "
"keeping natural lighting and perspective",
"images": [
{"url": "https://exemple.com/portrait.jpg"},
{"url": "https://exemple.com/batiment.jpg"}
]
}
Limity a osvědčené postupy
Technický limit je 5 obrázků na požadavek a v rámci stejného pole můžeš volně kombinovat formáty – některé zdroje jako URL, jiné jako Base64. Skutečná obtížnost však není zde: spočívá v přesnosti promptu, která musí růst s počtem obrázků. U dvou zdrojů často stačí „kombinuj postavu a prostředí“; u pěti zdrojů již model nemůže hádat, který prvek si vzít z kterého obrázku, a přesně zde přichází ke slovu reference <IMAGE_1> až <IMAGE_5>: „umísti logo z <IMAGE_2> na tričko postavy z <IMAGE_1> v atmosféře osvětlení z <IMAGE_3>“ nenechává žádnou nejednoznačnost. U složitých kompozic z více zdrojů si profesionální model (grok-imagine-image-quality) svou vyšší cenu plně оправдává: právě zde je nejviditelnější rozdíl oproti standardnímu modelu, a to v konzistenci mezi heterogenními prvky.
Praktické cvičení
Zkus zkombinovat dva obrázky, které máš po ruce:
payload = {
"model": "grok-imagine-image",
"prompt": "Create a scene where the object from <IMAGE_0> floats in the sky from <IMAGE_1>, "
"surrealist style",
"images": [
{"url": "URL_OF_YOUR_FIRST_IMAGE"},
{"url": "URL_OF_YOUR_SECOND_IMAGE"}
],
"n": 3
}
Vygeneruj 3 varianty a porovnej interpretace modelu.
Klíčové poznatky
- Parametr
imagespřijímá až 5 zdrojových obrázků v poli image(jednotné číslo) aimages(množné číslo) se vzájemně vylučují- Syntaxe
<IMAGE_0>,<IMAGE_1>ti umožňuje odkazovat se na každý obrázek v promptu - Mezi příklady využití patří přenos stylu, kompozice a fúze
- Při práci s více zdroji buď ve svém promptu co nejpřesnější