Ibbeljar fuq ħafna dawriet u retouching immirat
F'din il-paġna
Aġġornat fit-3 ta’ Novembru 2026. Ibbażat fuq il-paġna Image Editing, il-Image Prompting Guide, u r-referenza tal-API tal-Immaġni ta’ xAI: l-endpoint
/v1/images/editsm’għandux parametrumask—la fir-referenza u lanqas fl-xai-sdk1.21.0—kuntrarjament għal dak li kien iddikjarat fil-verżjoni preċedenti. Ir-retouching jiġi mmirat permezz tal-prompt, u żona tiġi protetta pixel-perfect b’maskra applikata lokalment, wara l-ibbeljar. Sorsi: Image Editing · Image Prompting Guide · Images API.
Katina ta’ Ibbljar (Chaining Edits)
L-ibbeljar tal-immaġni jsir verament qawwi meta tgħaqqad ħafna modifiki flimkien. Il-prinċipju, deskritt minn xAI, huwa sempliċi: l-output ta’ edit waħda jsir l-input tal-oħra, li jippermettilek tibda minn immaġni bażi u mbagħad iżżid dettalji, taġġusta l-istil, jew tikkoreġi, dawra wara dawra.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
def edit_image(image_url, prompt):
"""Jibbelja immaġni u jirritorna l-URL tar-riżultat."""
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"]
# Dawra 1: ibdel l-isfond
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."
)
# Dawra 2: aġġusta d-dawl
url_tour2 = edit_image(
url_tour1,
"Make the light warm and dim, like late afternoon. "
"Keep the same person, decor, and framing."
)
# Dawra 3: żid 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}")
L-Aħjar Prattiki għall-Ibbljar fuq Ħafna Dawriet
Il-gwida ta’ xAI tissuġġerixxi li tibbelja meta s-suġġett u t-tqassim diġà huma tajbin u hemm bżonn jinbidlu dettall wieħed sa tlieta biss; jekk is-suġġett innifsu huwa ħażin, huwa aħjar terġa’ tiġġenerah. Kull dawra tibda bil-modifika, imbagħad tiddikjara f’sentenza waħda x’inhu li ma jiċċaqlaqx: is-suġġett, l-angolu, il-qafas, jew il-pożizzjoni tal-oġġett. Skont il-gwida, żewġ formulazzjonijiet ifallu: waħda li tibda b‘“żomm kollox”, li tbiddel kważi xejn, u oħra li tikkopja prompt sħiħ, li terġa’ tikkomponi x-xena—fejn is-suġġett jidderieġi, oġġett jirdoppja, jew jinbidel f’oġġett ġar.
Ordna d-dawriet mill-ġenerali għall-ispeċifiku: l-isfond, il-kompożizzjoni u l-atmosfera l-ewwel, l-aċċessorji u l-korrezzjonijiet fini wara, sabiex bidla kbira tard ma tħassarx ir-retouches żgħar.
Żewġ prekawzjonijiet ta’ sigurtà jikkompletaw il-metodu. Niżżel kull riżultat intermedjarju hekk kif jiġi prodott: l-URLs huma temporanji, u li titlef id-dawra 3 minn serje ta’ ħamsa jfurzalek terġa’ tibda mid-dawra 2. U spezzjona kull pass qabel ma tgħaqqad: difett introdott fid-dawra 1—bħal subgħa distorta jew dell inkonsistenti—jispiċċa fid-dawriet kollha sussegwenti, peress li kull waħda tibda mill-immaġni preċedenti.
Immirar ta’ Żona permezz tal-Prompt
L-API ma taċċettax maskra: il-prompt huwa li jimmira. Indika l-parti li trid timmodifika bl-aktar mod preċiż possibbli—bl-isem, il-pożizzjoni, il-materjal—u semmi x’għandu jibqa’ identiku.
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."
)
Meta korrezzjoni ma taħdimx, il-gwida tirrakkomanda li tbiddel il-kliem minflok ma tirrepeti l-istess talba, billi tindika l-parti tal-immaġni li trid tikkoreġi u x’għandha turi. Biex tgħaqqad ħafna immaġni—prodott f’dekor, karattru minn immaġni għal oħra—l-ibbeljar jaċċetta sa ħames immaġni sors (lezzjoni 7).
Protezzjoni ta’ Żona Pixel-perfect: Il-Maskra Lokali
Jekk parti mill-immaġni m’għandhiex tiċċaqlaq pixel wieħed—bħal logo, wiċċ, jew test—applika l-maskra lokalment, wara l-ibbeljar: iżżomm iż-żona oriġinali u tieħu mill-edit biss dak li jinsab barra din iż-żona. Ma’ Pillow, Image.composite(image1, image2, mask) tikkopja image1 fejn il-maskra hija bajda u żżomm image2 fejn hija sewda:
from PIL import Image, ImageDraw
original = Image.open("original.jpg").convert("RGB")
edite = Image.open("edite.jpg").convert("RGB").resize(original.size)
# Maskra: abjad = ħu l-edit, iswed = żomm l-oriġinal
masque = Image.new("L", original.size, 255)
draw = ImageDraw.Draw(masque)
draw.rectangle([40, 40, 360, 160], fill=0) # żona protetta, eż. logo
resultat = Image.composite(edite, original, masque)
resultat.save("resultat.jpg")
It-tliet immaġni għandu jkollhom l-istess daqs. Il-bidla tad-daqs tassumi li l-edit żamm il-proporzjon tal-aspett tas-sors: ivverifika dan, jew infurzah bil-parametru aspect_ratio tat-talba. Il-maskra ma tipprevjenix lill-mudell milli jmiss iż-żona; tippermettilek tirrestawraha wara.
Pipeline Sħiħa tal-Ibbljar
Hawnhekk hemm eżempju ta’ pipeline strutturata, li żżomm l-istorja ta’ kull dawra:
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
Punti Ewlenin
- L-ibbeljar fuq ħafna dawriet iħabbat ir-riżultati: kull output isir l-input tal-edit li jmiss
- Ibbelja meta s-suġġett u t-tqassim ikunu tajbin u jkun hemm bżonn jinbidlu dettall wieħed sa tlieta biss
- Kull dawra: il-modifika l-ewwel, imbagħad x’għandu jibqa’ identiku
- L-API m’għandhiex parametru
mask: immira permezz tal-prompt, u ipproteġi żona b’maskra lokali applikata wara l-ibbeljar - L-URLs tal-output huma temporanji: niżżel ir-riżultati intermedjarji