Úpravy vo viacerých krokoch a cielené retušovanie
Na tejto strane
Aktualizované 3. novembra 2026. Na základe stránky Image Editing, Image Prompting Guide a referencie xAI Images API: koncový bod
/v1/images/editsnemá parametermask– ani v referencii, ani vxai-sdk1.21.0 – na rozdiel od toho, čo tvrdila predchádzajúca verzia. Retušovanie sa vykonáva cielené pomocou promptu a zóna sa chráni s presnosťou na pixel lokálne aplikovanou maskou až po úprave. Zdroje: Image Editing · Image Prompting Guide · Images API.
Reťazenie úprav
Úprava obrázkov sa stáva skutočne výkonnou, keď prepojíš viacero modifikácií. Princíp, ktorý opisuje xAI, je jednoduchý: výstup jednej úpravy sa stáva vstupom pre ďalšiu, čo ti umožňuje začať so základným obrázkom a následne pridávať detaily, upravovať štýl alebo opravovať chyby krok za krokom.
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ázok a vráti 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: úprava pozadia
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 osvetlenia
url_tour2 = edit_image(
url_tour1,
"Make the light warm and dim, like late afternoon. "
"Keep the same person, decor, and framing."
)
# Krok 3: pridanie 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}")
Najlepšie postupy pri úpravách vo viacerých krokoch
Príručka xAI odporúča upravovať obrázky vtedy, keď sú predmet a rozloženie už dobré a treba zmeniť iba jeden až tri detaily; ak je samotný predmet nesprávny, je lepšie vygenerovať ho znova. Každý krok začína opisom modifikácie a následne v jednej vete špecifikuje, čo sa nemení: predmet, uhol, orezanie alebo umiestnenie objektov. Podľa príručky zlyhávajú dva prístupy: prvý, ktorý začína frázou „zachovaj všetko“, čo takmer nič nezmení, a druhý, ktorý kopíruje celý prompt, čím sa scéna recomponuje – predmet sa posunie, objekt sa zdvojnásobí alebo sa zmení na susedný objekt.
Usporiadaj kroky od všeobecného ku konkrétnemu: najprv pozadie, kompozícia a atmosféra, potom doplnky a jemné korekcie, aby neskoršia zásadná zmena nezrušila predchádzajúce drobné retuše.
Metódu dopĺňajú dve bezpečnostné opatrenia. Stiahni si každý priebežný výsledok hneď, ako vznikne: URL adresy sú dočasné a strata tretieho kroku v sérii piatich ťa núti začať znova od druhého kroku. A skontroluj každý krok pred tým, než pokračuješ ďalej: chyba zavedená v prvom kroku – napríklad deformovaný prst alebo nekonzistentný tieň – sa preniesť do všetkých nasledujúcich krokov, keďže každý z nich vychádza z predchádzajúceho obrázka.
Cielenie na zónu pomocou promptu
API neprijíma masku: cieľ určuješ promptom. Časť, ktorú chceš upraviť, označ čo najpresnejšie – podľa názvu, polohy, materiálu – a pomenuj, čo musí zostať identické.
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."
)
Keď korekcia nezaberie, príručka odporúča zmeniť slová namiesto opakovania tej istej požiadavky, pričom určíš časť obrázka na opravu a to, čo má zobrazovať. Na spojenie viacerých obrázkov – produktu v interiéri, postavy z jedného obrázka do druhého – úprava akceptuje až päť zdrojových obrázkov (lekcia 7).
Ochrana zóny s presnosťou na pixel: Lokálna maska
Ak sa časť obrázka nesmie posunúť ani o pixel – logo, tvár, text – aplikuj masku lokálne až po úprave: zachováš pôvodnú zónu a z upravenej verzie vezmeš len to, čo leží mimo tejto zóny. Pomocou knižnice Pillow funkcia Image.composite(image1, image2, mask) skopíruje image1 tam, kde je maska biela, a zachová image2 tam, kde je čierna:
from PIL import Image, ImageDraw
original = Image.open("original.jpg").convert("RGB")
edite = Image.open("edite.jpg").convert("RGB").resize(original.size)
# Maska: biela = prevziať úpravu, čierna = zachovať originál
masque = Image.new("L", original.size, 255)
draw = ImageDraw.Draw(masque)
draw.rectangle([40, 40, 360, 160], fill=0) # chránená zóna, napr. logo
resultat = Image.composite(edite, original, masque)
resultat.save("resultat.jpg")
Všetky tri obrázky musia mať rovnakú veľkosť. Zmena veľkosti predpokladá, že úprava zachovala pomer strán zdroja: over si to, alebo ho vynúť pomocou parametra aspect_ratio v požiadavke. Maska nebráni modelu zasahovať do zóny; umožňuje ti ju následne obnoviť.
Kompletný pipeline úprav
Tu je príklad štruktúrovaného pipeline, ktorý uchováva históriu 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
Kľúčové poznatky
- Úpravy vo viacerých krokoch reťazia výsledky: každý výstup sa stáva vstupom pre ďalšiu úpravu
- Upravuj, keď sú predmet a rozloženie dobré a treba zmeniť iba jeden až tri detaily
- Každý krok: najprv modifikácia, potom to, čo musí zostať identické
- API nemá parameter
mask: cieľ určuj pomocou promptu a zónu chráň lokálnou maskou aplikovanou po úprave - Výstupné URL adresy sú dočasné: sťahuj si priebežné výsledky