Uređivanje u više koraka i ciljano retuširanje
Na ovoj stranici
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/editsnema parametarmask—ni u referenci ni uxai-sdk1.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