Immodifika stampi eżistenti (inpainting, outpainting)
F'din il-paġna
Aġġornat fit-2 ta’ Novembru, 2026 — Mudelli tal-immaġni.
gpt-image-1, il-mudell li għalih kien miktub oriġinarjament dan il-kors, ġie deprekat fl-23 ta’ Ottubru, 2026. Barra minn hekk,gpt-image-1.5,gpt-image-1-mini, uchatgpt-image-latestse jiġu rtirati fl-1 ta’ Diċembru, 2026. L-eżempji issa jużawgpt-image-2.5-sunburst, li joffri l-ogħla preċiżjoni għall-editjar;gpt-image-2.5-flarehuwa aktar mgħaġġel għall-ġenerazzjoni ġenerali. Iż-żewġ mudelli jappoġġjaw ukoll il-kwalitajietxhighumax. Il-mudelli GPT Image dejjem jirritornaw l-immaġni f’base64: il-parametruresponse_formatużat mill-mudelli DALL·E eqdem m’għadux aċċettat u tneħħa mill-kodiċi. Sors: Image generation (OpenAI).
Immodifika stampi eżistenti
Il-metodu client.images.edit() jimmodifika stampa eżistenti billi juża maskra biex jiddefinixxi ż-żona li trid tiġi rriġenerata. Dan iwassal għal żewġ każijiet ta’ użu distinti, li jiswielhom issemmihom b’mod preċiż peress li jeħtieġu maskri differenti. L-inpainting jimla jew jissostitwixxi żona interna—tista’ tbiddel is-sema f’pajsaġġ, l-iskrin fuq kompjuter, jew il-kulur ta’ ħajt. L-outpainting, min-naħa l-oħra, jestendi l-immaġni lil hinn mill-fruntieri oriġinali tagħha, bħal meta tbiddel ritratt kwadru f’banner panoramiku.
Kif taħdem il-maskra
Il-maskra hija immaġni PNG bl-istess dimensjonijiet tal-immaġni sors. Iż-żoni trasparenti (alpha = 0) jindikaw fejn il-mudell għandu jiġġenera kontenut ġdid; iż-żoni opaki jibqgħu intatti. Din il-konvenzjoni hija kontra l-intuwizzjoni fil-bidu: naturalment trid “tippenġi” dak li trid tbiddel, iżda fil-fatt għandek bżonn taqta’ toqba fil-maskra minflok. Is-sejħa tal-API nnifisha tibqa’ sempliċi, u teħtieġ biss iż-żewġ fajls u deskrizzjoni ta’ x’għandu jidher.
import base64
from openai import OpenAI
client = OpenAI()
response = client.images.edit(
model="gpt-image-2.5-sunburst",
image=open("desk_photo.png", "rb"),
mask=open("desk_mask.png", "rb"),
prompt="A computer screen displaying a modern analytics dashboard"
)
with open("edited_desk.png", "wb") as f:
f.write(base64.b64decode(response.data[0].b64_json))
M’għandekx bżonn editur grafiku biex toħloq din il-maskra. Pillow tista’ tiġġenera waħda f’ftit linji biss: ibda b’saff kompletament opaku li jaqbel mad-dimensjonijiet tas-sors, imbagħad pinġi l-forma li trid tagħmel trasparenti. L-iskritt ta’ hawn taħt joħloq tieqa rettangolari fiċ-ċentru tal-immaġni.
from PIL import Image, ImageDraw
# Iftaħ l-immaġni sors biex tikseb id-dimensjonijiet tagħha
source = Image.open("desk_photo.png")
width, height = source.size
# Oħloq maskra kompletament opaka (iswed)
mask = Image.new("RGBA", (width, height), (0, 0, 0, 255))
draw = ImageDraw.Draw(mask)
# Pinġi żona trasparenti (iż-żona li trid timmodifika)
# Rettangolu fiċ-ċentru tal-immaġni
x1, y1 = width // 4, height // 4
x2, y2 = 3 * width // 4, 3 * height // 4
draw.rectangle([x1, y1, x2, y2], fill=(0, 0, 0, 0))
mask.save("desk_mask.png")
print(f"Mask created: {width}x{height}, editable area in center")
Inpainting: Issostitwixxi element
Ladarba tirrepeti din l-operazzjoni, jagħmel sens li tikkapsula l-ħolqien tal-maskra u s-sejħa tal-API f’funzjoni waħda, parametrizzata mir-reġjun li trid timmodifika. Il-prompt imbagħad għandu jiddeskrivi biss il-kontenut mistenni fi ħdan iż-żona maskrata, qatt il-bqija tal-immaġni. L-eżempju ta’ hawn taħt japplika din il-funzjoni għal ritratt ta’ pajsaġġ, u jimmodifika biss l-ewwel 400 pixel—is-sema—biex jagħtih atmosfera temporaleska.
from openai import OpenAI
from PIL import Image, ImageDraw
import base64
client = OpenAI()
def inpaint_region(image_path, region, prompt, output_path):
"""
Issostitwixxi reġjun rettangolari f'immaġni.
region: tuple (x1, y1, x2, y2) f'pixel
"""
# Oħloq il-maskra
source = Image.open(image_path)
mask = Image.new("RGBA", source.size, (0, 0, 0, 255))
draw = ImageDraw.Draw(mask)
draw.rectangle(region, fill=(0, 0, 0, 0))
mask.save("temp_mask.png")
# Sejjaħ l-API
response = client.images.edit(
model="gpt-image-2.5-sunburst",
image=open(image_path, "rb"),
mask=open("temp_mask.png", "rb"),
prompt=prompt
)
# Salva r-riżultat
with open(output_path, "wb") as f:
f.write(base64.b64decode(response.data[0].b64_json))
print(f"Edited image saved: {output_path}")
# Eżempju: Issostitwixxi s-sema f'ritratt ta' pajsaġġ
inpaint_region(
image_path="landscape.png",
region=(0, 0, 1024, 400), # Parti ta' fuq = is-sema
prompt="Dramatic sky with purple storm clouds at sunset",
output_path="landscape_sky_edited.png"
)
Outpainting: Estendi l-immaġni
It-tkabbir ta’ immaġni jeħtieġ pass addizzjonali għax l-API ma tistax tiġġenera kontenut “maġenb” fajl direttament. L-ewwel trid toħloq kanvas akbar, twaħħal l-oriġinal fuqu, u tipprovdi maskra li tipproteġi eżattament iż-żona okkupata minn dak l-oriġinal. Il-loġika kollha tiddependi fuq il-kalkolu tad-dimensjonijiet il-ġodda u l-pożizzjoni tat-twaħħil ibbażata fuq id-direzzjoni mitluba.
from openai import OpenAI
from PIL import Image
import base64
from io import BytesIO
client = OpenAI()
def outpaint(image_path, direction, extra_pixels, prompt, output_path):
"""
Estendi immaġni f'direzzjoni mogħtija.
direction: 'right', 'bottom', 'left', 'top'
extra_pixels: numru ta' pixel biex iżżid
"""
source = Image.open(image_path).convert("RGBA")
w, h = source.size
# Ikkalkula d-dimensjonijiet il-ġodda
if direction == "right":
new_size = (w + extra_pixels, h)
paste_pos = (0, 0)
elif direction == "bottom":
new_size = (w, h + extra_pixels)
paste_pos = (0, 0)
elif direction == "left":
new_size = (w + extra_pixels, h)
paste_pos = (extra_pixels, 0)
elif direction == "top":
new_size = (w, h + extra_pixels)
paste_pos = (0, extra_pixels)
# Oħloq il-kanvas estiż (trasparenti = żona li tiġġenera)
extended = Image.new("RGBA", new_size, (0, 0, 0, 0))
extended.paste(source, paste_pos)
# Il-maskra: trasparenti kullimkien ħlief fejn titqiegħed l-immaġni oriġinali
mask = Image.new("RGBA", new_size, (0, 0, 0, 0))
opaque = Image.new("RGBA", (w, h), (0, 0, 0, 255))
mask.paste(opaque, paste_pos)
# Salva temporanjament
extended.save("temp_extended.png")
mask.save("temp_mask_outpaint.png")
response = client.images.edit(
model="gpt-image-2.5-sunburst",
image=open("temp_extended.png", "rb"),
mask=open("temp_mask_outpaint.png", "rb"),
prompt=prompt
)
with open(output_path, "wb") as f:
f.write(base64.b64decode(response.data[0].b64_json))
print(f"Extended image saved: {output_path}")
# Estendi ritratt lejn il-lemin
outpaint(
image_path="portrait.png",
direction="right",
extra_pixels=512,
prompt="Natural continuation of the scene, same lighting and background",
output_path="portrait_extended.png"
)
Innota l-formulazzjoni tal-prompt tal-estensjoni: “kontinwazzjoni naturali tax-xena, l-istess dawl u sfond”. Fl-outpainting, m’intix tiddeskrivi suġġett ġdid; qed titlob lill-mudell jestendi dak li diġà jara. Prompt kreattiv wisq jipproduċi ħjata viżibbli bejn l-oriġinal u ż-żona miżjuda.
Editjar iterattiv
Xejn ma jwaqqafek milli tgħaqqad editjar multipli fuq l-istess immaġni, billi tuża kull output bħala input għall-pass li jmiss. Din hija l-aktar mod affidabbli biex tibni kompożizzjoni kumplessa: ittratta l-isfond l-ewwel, imbagħad il-quddiem, b’maskra ddedikata għal kull pass, minflok ma tama li prompt wieħed se jissewwa kollox f’daqqa.
import base64
from openai import OpenAI
client = OpenAI()
def edit_step(image_path, mask_path, prompt, output_path):
response = client.images.edit(
model="gpt-image-2.5-sunburst",
image=open(image_path, "rb"),
mask=open(mask_path, "rb"),
prompt=prompt
)
with open(output_path, "wb") as f:
f.write(base64.b64decode(response.data[0].b64_json))
return output_path
# Pass 1: Immodifika l-isfond
step1 = edit_step(
"scene.png", "mask_background.png",
"Lush tropical forest background",
"scene_step1.png"
)
# Pass 2: Żid element fil-quddiem
step2 = edit_step(
step1, "mask_foreground.png",
"A colorful macaw parrot perched on a branch",
"scene_step2.png"
)
print(f"Final result: {step2}")
Limitazzjonijiet ewlenin
Erba’ regoli tekniċi jirregolaw is-suċċess tas-sejħa. Il-ksur ta’ kwalunkwe waħda minnhom jirriżulta f’żurur immedjat minflok riżultat iddegradat.
- L-immaġni sors u l-maskra għandu jkollhom l-istess dimensjonijiet
- Iż-żewġ fajls iridu jkunu fil-format PNG
- Id-daqs massimu għal kull fajl huwa 4 MB
- Il-maskra tuża l-kanal alpha biex tiddefinixxi ż-żoni li jistgħu jiġu editjati
Osservazzjoni empirika tiżdied ma’ dawn il-limitazzjonijiet: ir-riżultati huma aktar konsistenti meta ż-żona maskrata tirrappreżenta inqas minn 50% tal-immaġni. Lil hinn minn hekk, il-mudell ikollu ftit wisq kuntest biex jgħaqqad sewwa, u spiss tikseb riżultati aħjar billi taqsam il-modifika tiegħek f’żewġ editjar suċċessivi.
Poġġi dan fil-prattika b’ritratt tad-desk tiegħek jew kwalunkwe immaġni mingħajr royalties: ikteb skritt li awtomatikament jiġġenera maskra fuq ir-raba’ ta’ fuq tal-immaġni, jissostitwixxi dik iż-żona b’sema mimli stilel, u jsalva r-riżultat lokalment.