Úpravy ve více krocích a cílené retuše
Na této stránce
Aktualizováno 3. listopadu 2026. Na základě stránky Image Editing, průvodce Image Prompting Guide a reference k API xAI Images: koncový bod
/v1/images/editsnemá parametrmask– ani v referenci, ani vxai-sdk1.21.0 – na rozdíl od toho, co tvrdila předchozí verze. Retuše se cílí pomocí promptu a zóna se chrání s přesností na pixel pomocí masky aplikované lokálně až po úpravě. Zdroje: Image Editing · Image Prompting Guide · Images API.
Řetězení úprav
Úprava obrázků získává skutečnou sílu, když zkombinuješ více modifikací. Princip, který popisuje xAI, je jednoduchý: výstup jedné úpravy se stává vstupem pro další. To ti umožňuje začít se základním obrázkem a poté krok za krokem přidávat detaily, upravovat styl nebo provádět opravy.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
def edit_image(image_url, prompt):
"""Upraví obrázek a vrátí URL výsledku."""
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json={
"model": "grok-imagine-image",
"prompt": prompt,
"image": {"url": image_url}
}
)
response.raise_for_status()
return response.json()["data"][0]["url"]
# Krok 1: změna pozadí
url_tour1 = edit_image(
"https://exemple.com/portrait.jpg",
"Replace the background with a modern office overlooking the city. "
"Keep the same person, pose, and framing."
)
# Krok 2: úprava osvětlení
url_tour2 = edit_image(
url_tour1,
"Make the light warm and dim, like late afternoon. "
"Keep the same person, decor, and framing."
)
# Krok 3: přidání prvku
url_tour3 = edit_image(
url_tour2,
"Place an open laptop on the desk, in front of the person. "
"Keep the same person, lighting, and framing."
)
print(f"Final result: {url_tour3}")
Osvědčené postupy pro úpravy ve více krocích
Průvodce xAI doporučuje upravovat obrázky pouze tehdy, když jsou předmět a rozložení již dobré a je třeba změnit jen jeden až tři detaily. Pokud je samotný předmět špatný, je lepší generovat znovu. Každý krok začne popisem modifikace a následně v jedné větě uvede, co se nemění: předmět, úhel, ořez nebo umístění objektů.
Podle průvodce selhávají dva typy formulací: první začíná frází „zachovej vše“, což téměř nic nezmění, a druhá kopíruje celý původní prompt, což scénu znovu komponuje – předmět se posune, objekt se zdvojnásobí nebo se změní v sousední objekt.
Kroky seřaď od obecného ke konkrétnímu: nejprve pozadí, kompozice a atmosféra, poté doplňky a jemné opravy. Díky tomu pozdější zásadní změna nezruší dříve provedené drobné retuše.
Metodu doplňují dvě bezpečnostní opatření. Každý průběžný výsledek si ihned po vygenerování stáhni: URL adresy jsou dočasné a ztráta třetího kroku v sérii pěti by tě donutila restartovat od druhého kroku. Před řetězením také zkontroluj každý krok: chyba zavedená v prvním kroku – například deformovaný prst nebo nekonzistentní stín – se objeví ve všech následujících krocích, protože každý z nich vychází z předchozího obrázku.
Cílení na zónu pomocí promptu
API nemá žádnou masku: cílení probíhá prostřednictvím promptu. Část, kterou chceš upravit, označ co nejpřesněji – podle názvu, pozice nebo materiálu – a jasně pojmenuj, co musí zůstat stejné.
url_chapeau = edit_image(
url_tour3,
"Replace the person's cap with a wide-brimmed straw hat. "
"Keep the same face, hairstyle, decor, and framing."
)
Pokud oprava nezabere, průvodce doporučuje změnit slova místo opakování stejného požadavku. Přesně označ část obrázku k opravě a popiš, co má zobrazovat. Pro sestavení více obrázků – například produktu v interiéru nebo postavy z jednoho obrázku do jiného – úprava přijímá až pět zdrojových obrázků (lekce 7).
Ochrana zóny s přesností na pixel: Lokální maska
Pokud se část obrázku nesmí ani o pixel pohnout – logo, obličej, text – aplikuj masku lokálně až po úpravě: zachováš původní zónu a z upravené verze vezmeš pouze to, co leží mimo tuto zónu. Pomocí knihovny Pillow funkce Image.composite(image1, image2, mask) zkopíruje image1 tam, kde je maska bílá, a ponechá image2 tam, kde je černá:
from PIL import Image, ImageDraw
original = Image.open("original.jpg").convert("RGB")
edite = Image.open("edite.jpg").convert("RGB").resize(original.size)
# Maska: bílá = vzít úpravu, černá = ponechat originál
masque = Image.new("L", original.size, 255)
draw = ImageDraw.Draw(masque)
draw.rectangle([40, 40, 360, 160], fill=0) # chráněná zóna, např. logo
resultat = Image.composite(edite, original, masque)
resultat.save("resultat.jpg")
Všechny tři obrázky musí mít stejnou velikost. Změna velikosti předpokládá, že úprava zachovala poměr stran zdroje: ověř si to, nebo jej vynuť pomocí parametru aspect_ratio v požadavku. Maska nezabrání modelu, aby se zóny dotkl; umožňuje ti ji následně obnovit.
Kompletní pipeline pro úpravy
Zde je příklad strukturované pipeline, která uchovává historii každého kroku:
class ImageEditor:
def __init__(self, api_key):
self.headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
self.history = []
def edit(self, image_url, prompt):
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=self.headers,
json={
"model": "grok-imagine-image",
"prompt": prompt,
"image": {"url": image_url}
}
)
response.raise_for_status()
result_url = response.json()["data"][0]["url"]
self.history.append({
"prompt": prompt,
"input": image_url,
"output": result_url
})
return result_url
Klíčové poznatky
- Úpravy ve více krocích řetězí výsledky: každý výstup se stává vstupem pro další úpravu
- Upravuj, když jsou předmět a rozložení dobré a je třeba změnit jen jeden až tři detaily
- Každý krok: nejprve modifikace, poté to, co musí zůstat stejné
- API nemá parametr
mask: cíli pomocí promptu a zónu chraň lokální maskou aplikovanou po úpravě - Výstupní URL jsou dočasné: stahuj si průběžné výsledky