Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Uređivanje u više koraka i ciljano retuširanje

Lekcija 8 od 14 Ažurirano 3. studenoga 2026. Početnik
Na ovoj stranici
  1. Lančano uređivanje
  2. Ciljanje zone putem upita
  3. Savršena zaštita zone: lokalna maska
  4. Potpuni pipeline uređivanja
  5. Ključne točke

Ažurirano 3. studenoga 2026. Na temelju stranice Image Editing, vodiča Image Prompting Guide i referencije xAI Images API-ja: krajnja točka /v1/images/edits nema parametar mask—ni u referenci ni u xai-sdk 1.21.0—suprotno tvrdnjama prethodne verzije. Retuširanje se cilja putem upita (prompt), a zona se savršeno štiti maskom primijenjenom lokalno, nakon uređivanja. Izvori: Image Editing · Image Prompting Guide · Images API.

Lančano uređivanje

Uređivanje slika postaje doista moćno kada povežeš više izmjena. Načelo koje opisuje xAI jednostavno je: izlaz jednog uređivanja postaje ulaz sljedećeg, što ti omogućuje da kreneš od osnovne slike, a zatim dodaješ detalje, prilagođavaš stil ili ispravljaš greške, korak po korak.

import requests
import os

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

def edit_image(image_url, prompt):
    """Uređuje sliku i vraća 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: promijeni pozadinu
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: prilagodi osvjetljenje
url_tour2 = edit_image(
    url_tour1,
    "Make the light warm and dim, like late afternoon. "
    "Keep the same person, decor, and framing."
)

# Korak 3: dodaj element
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}")

Najbolje prakse za uređivanje u više koraka

xAI vodič savjetuje uređivanje kada su subjekt i raspored već dobri te treba promijeniti samo jedan do tri detalja; ako je sam subjekt pogrešan, bolje je ponovno generirati sliku. Svaki korak započinje opisom izmjene, a zatim u jednoj rečenici navodi što se ne mijenja: subjekt, kut, kadrovanje ili raspored objekata. Prema vodiču, dva formuliranja ne uspijevaju: ono koje počinje s „zadrži sve“, jer gotovo ništa ne mijenja, i ono koje kopira cijeli upit, jer ponovno komponira scenu—subjekt odluta, objekt se udvostruči ili se pretvori u susjedni objekt.

Poredaj korake od općeg prema specifičnom: prvo pozadina, kompozicija i atmosfera, zatim dodaci i sitne ispravke, kako kasnija velika promjena ne bi poništila mala retuširanja.

Dvije sigurnosne mjere nadopunjuju ovu metodu. Preuzmi svaki međurezultat čim se stvori: URL-ovi su privremeni, a gubitak trećeg koraka u nizu od pet prisiljava te da kreneš ispočetka od drugog koraka. I pregledaj svaki korak prije lančanog povezivanja: nedostatak uveden u prvom koraku—isprsteni prst, nedosljedna sjena—završava u svim narednim koracima, jer svaki polazi od prethodne slike.

Ciljanje zone putem upita

API ne prihvaća masku: upit cilja. Odredi dio koji treba modificirati što preciznije—imenom, položajem, materijalom—i imenuj ono što mora ostati identično.

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

Kada ispravak ne uspije, vodič preporučuje promjenu riječi umjesto ponavljanja istog zahtjeva, precizirajući dio slike koji treba ispraviti i što on treba prikazivati. Za spajanje više slika—proizvod u interijeru, lik s jedne slike na drugu—uređivanje prihvaća do pet izvornih slika (lekcija 7).

Savršena zaštita zone: lokalna maska

Ako se dio slike ne smije pomaknuti ni za piksel—logo, lice, tekst—primijeni masku lokalno, nakon uređivanja: zadržavaš izvornu zonu, a iz uređene slike uzimaš samo ono što je izvan te zone. Uz Pillow, Image.composite(image1, image2, mask) kopira image1 tamo gdje je maska bijela, a zadržava image2 tamo gdje je crna:

from PIL import Image, ImageDraw

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

# Maska: bijelo = uzmi uređeno, crno = zadrži original
masque = Image.new("L", original.size, 255)
draw = ImageDraw.Draw(masque)
draw.rectangle([40, 40, 360, 160], fill=0)  # zaštićena zona, npr. logo

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

Sve tri slike moraju imati istu veličinu. Promjena veličine podrazumijeva da je uređivanje zadržalo omjer izvorne slike: provjeri to ili ga nametni parametrom aspect_ratio u zahtjevu. Maska ne sprječava model da dodirne zonu; ona ti omogućuje da je naknadno obnoviš.

Potpuni pipeline uređivanja

Evo primjera strukturiranog pipelinea koji čuva povijest svakog 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 točke

  • Lančano uređivanje povezuje rezultate: svaki izlaz postaje ulaz sljedećeg uređivanja
  • Uređuj kada su subjekt i raspored dobri te treba promijeniti samo jedan do tri detalja
  • Svaki korak: prvo izmjena, zatim ono što mora ostati identično
  • API nema parametar mask: ciljaj putem upita, a zonu zaštiti lokalnom maskom primijenjenom nakon uređivanja
  • URL-ovi izlaza su privremeni: preuzmi međurezultate