Urejanje v več korakih in ciljno retuširanje
Na tej strani
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/editsnima parametramask– niti v referenci niti vxai-sdk1.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