Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Urejanje v več korakih in ciljno retuširanje

Lekcija 8 od 14 Posodobljeno 3. november 2026 Začetnik
Na tej strani
  1. Povezovanje urejanj
  2. Ciljanje območja prek poziva
  3. Zaščita območja na ravni piksela: lokalna maska
  4. Celoten potek urejanja
  5. Ključne ugotovitve

Posodobljeno 3. novembra 2026. Na podlagi strani Image Editing, vodnika Image Prompting Guide in referenčne dokumentacije API-ja xAI Images: končna točka /v1/images/edits nima parametra mask – niti v referenci niti v xai-sdk 1.21.0 – kar je v nasprotju s trditvami prejšnje različice. Retuširanje se izvaja ciljno prek poziva (prompt), območje pa se zaščiti na ravni piksela z masko, ki se uporabi lokalno po urejanju. Viri: Image Editing · Image Prompting Guide · Images API.

Povezovanje urejanj

Urejanje slik postane resnično zmogljivo, ko povežeš več sprememb. Načelo, ki ga opisuje xAI, je preprosto: izhod enega urejanja postane vhod za naslednje, kar ti omogoča, da začneš z osnovno sliko in nato korak za korakom dodajaš podrobnosti, prilagajaš slog ali popravljaš napake.

import requests
import os

headers = {
    "Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
    "Content-Type": "application/json"
}

def edit_image(image_url, prompt):
    """Uredi sliko in vrne URL rezultata."""
    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"]

# Korak 1: sprememba ozadja
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."
)

# Korak 2: prilagoditev osvetlitve
url_tour2 = edit_image(
    url_tour1,
    "Make the light warm and dim, like late afternoon. "
    "Keep the same person, decor, and framing."
)

# Korak 3: dodajanje elementa
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}")

Najboljše prakse za urejanje v več korakih

Vodnik xAI svetuje urejanje, ko sta subjekt in postavitev že dobra in je treba spremeniti le eno do tri podrobnosti; če je sam subjekt napačen, je bolje ponovno generirati sliko. Vsak korak se začne z opisom spremembe, nato pa v enem stavku navedeš, kaj se ne sme premakniti: subjekt, kot, kadriрование ali postavitev predmetov. Po mnenju vodnika dve formulaciji ne delujeta: prva se začne z „ohrani vse”, kar skoraj ničesar ne spremeni, druga pa kopira celoten poziv, kar ponovno sestavi sceno – subjekt se premakne, predmet se podvoji ali se spremeni v sosednji predmet.

Korake razporedi od splošnega k specifičnemu: najprej ozadje, kompozicija in vzdušje, nato dodatki in fine popravke, tako da poznejša večja sprememba ne razveljavi manjših retuširanj.

Metodo dopolnjujeta dva varnostna ukrepa. Vsak vmesni rezultat prenesi takoj, ko je ustvarjen: URL-ji so začasni in izguba tretjega koraka v seriji petih te prisili, da začneš znova od drugega koraka. In pred povezovanjem pregledaj vsak korak: napaka, uvedena v prvem koraku – popačen prst, neskladna senca – se prenese v vse naslednje korake, saj vsak izhaja iz prejšnje slike.

Ciljanje območja prek poziva

API ne sprejema maske: ciljaš s pozivom. Del, ki ga želiš spremeniti, označi čim natančneje – po imenu, položaju, materialu – in poimenuj, kaj mora ostati enako.

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."
)

Ko popravek ne uspe, vodnik priporoča spremembo besed namesto ponavljanja iste zahteve, pri čemer določiš del slike, ki ga je treba popraviti, in kaj naj prikazuje. Za združevanje več slik – izdelek v okolju, lik iz ene slike v drugo – urejanje sprejme do pet izvornih slik (lekcija 7).

Zaščita območja na ravni piksela: lokalna maska

Če se del slike ne sme premakniti niti za piksel – logotip, obraz, besedilo – masko uporabi lokalno po urejanju: obdržiš izvirno območje in iz urejene slike obdržiš le tisto, kar je zunaj tega območja. S knjižnico Pillow Image.composite(image1, image2, mask) kopira image1 tam, kjer je maska bela, in obdrži image2 tam, kjer je črna:

from PIL import Image, ImageDraw

original = Image.open("original.jpg").convert("RGB")
edite = Image.open("edite.jpg").convert("RGB").resize(original.size)

# Maska: belo = vzemi urejeno, črno = obdrži izvirno
masque = Image.new("L", original.size, 255)
draw = ImageDraw.Draw(masque)
draw.rectangle([40, 40, 360, 160], fill=0)  # zaščiteno območje, npr. logotip

resultat = Image.composite(edite, original, masque)
resultat.save("resultat.jpg")

Vse tri slike morajo imeti enako velikost. Spreminjanje velikosti predpostavlja, da je urejanje ohranilo razmerje stranic izvornika: preveri to ali ga vsili s parametrom aspect_ratio v zahtevi. Maska ne prepreči modelu, da se dotakne območja; omogoča ti, da ga nato obnoviš.

Celoten potek urejanja

Tukaj je primer strukturiranega poteka, ki ohranja zgodovino vsakega koraka:

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

Ključne ugotovitve

  • Urejanje v več korakih povezuje rezultate: vsak izhod postane vhod za naslednje urejanje
  • Urejaj, ko sta subjekt in postavitev dobra in je treba spremeniti le eno do tri podrobnosti
  • Vsak korak: najprej sprememba, nato kaj mora ostati enako
  • API nima parametra mask: ciljaj s pozivom in zaščiti območje z lokalno masko, uporabljeno po urejanju
  • Izhodni URL-ji so začasni: prenesi vmesne rezultate