Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Úpravy vo viacerých krokoch a cielené retušovanie

Lekcia 8 z 14 Aktualizované 3. novembra 2026 Začiatočník
Na tejto strane
  1. Reťazenie úprav
  2. Cielenie na zónu pomocou promptu
  3. Ochrana zóny s presnosťou na pixel: Lokálna maska
  4. Kompletný pipeline úprav
  5. Kľúčové poznatky

Aktualizované 3. novembra 2026. Na základe stránky Image Editing, Image Prompting Guide a referencie xAI Images API: koncový bod /v1/images/edits nemá parameter mask – ani v referencii, ani v xai-sdk 1.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