Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Úpravy ve více krocích a cílené retuše

Lekce 8 z 14 Aktualizováno 3. listopadu 2026 Začátečník
Na této stránce
  1. Řetězení úprav
  2. Cílení na zónu pomocí promptu
  3. Ochrana zóny s přesností na pixel: Lokální maska
  4. Kompletní pipeline pro úpravy
  5. Klíčové poznatky

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/edits nemá parametr mask – ani v referenci, ani v xai-sdk 1.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