L-API ta' Ġenerazzjoni tal-Immaġni fl-2026
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 interrott fil-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-aktar preċiżjoni għall-editjar;gpt-image-2.5-flarehuwa aktar mgħaġġel għall-ġenerazzjoni standard. Iż-żewġ mudelli jappoġġjaw ukoll il-kwalitajietxhighumax. Il-mudelli GPT Image dejjem jirritornaw immaġni f’base64: il-parametruresponse_formatminn mudelli DALL·E aktar antiki mhux appoġġjat u tneħħa mill-kodiċi. Sors: Ġenerazzjoni tal-immaġni (OpenAI).
L-API ta’ Ġenerazzjoni tal-Immaġni fl-2026
Il-ġenerazzjoni tal-immaġni bl-AI evolviet b’mod sinifikanti. Fl-2026, GPT Image huwa l-mudell ta’ referenza ta’ OpenAI biex toħloq u teditja immaġni permezz tal-API; dan issostitwixxi l-mudelli DALL·E 2 u DALL·E 3 li issa saru obsoleti. Jekk għandek kodiċi eżistenti għal dawn il-ġenerazzjonijiet preċedenti, ittrattah bħala punt tat-tluq għal riscrittura aktar milli bħala bażi li żżomm: il-parametri, il-formati tar-ritorn, u speċjalment l-istrateġiji tal-inġinerija tal-prompt kollha nbidlu.
Din il-lezzjoni tintroduċi l-ekosistema attwali, il-kapaċitajiet ta’ GPT Image, u kif se tinteraġixxi mal-API matul dan il-kors.
X’Jibdel GPT Image
L-ewwel bidla kbira tinvolvi t-test. Il-ġenerazzjonijiet preċedenti kienu jipproduċu ittri approssimattivi, dekorattivi iżda illegibbli; GPT Image jirrendi tipografija feddejli, u finalment jagħmel posters, banners promozzjonali, u mockups tal-interfaċċja vijabbli fejn il-messaġġ huwa importanti daqs l-immaġni. It-tieni bidla tikkonċerna l-fehim kuntestwali: il-mudell jinterpreta struzzjonijiet kumplessi b’nuansa, hekk li prompt ta’ diversi sentenzi li jiddeskrivi xena, id-dawl tagħha, u l-qafas jipproduċi riżultat koerenti minflok kollaġ ta’ kliem ewlieni.
Imbagħad hemm l-editjar nativ. M’għadekx tibdel sistematikament minn paġna vojta: il-mudell jista’ jimmodifika immaġni eżistenti billi jissostitwixxi żona interna (inpainting) jew jestendi l-immaġni lil hinn mill-fruntieri tagħha (outpainting). Prattikament, il-bidla tas-sema f’ritratt tal-pajsaġġ ma teħtieġx li terġa’ tiġġenera kollox u titlef is-suġġett fil-proċess. Ma’ dan jiżdied il-konsistenza stilistika miżmuma bejn ġenerazzjonijiet suċċessivi—valwuża meta tipproduċi serje ta’ illustrazzjonijiet għall-istess artikolu—u għażliet multipli ta’ riżoluzzjoni, minn formati kwadri sa dawk vertikali u orizzontali.
Iż-Żewġ Endpoints Prinċipali
L-API tesponi żewġ metodi, li se tesplora fid-dettal fil-lezzjonijiet sussegwenti. L-ewwel wieħed joħloq immaġni minn deskrizzjoni testwali.
import base64
from openai import OpenAI
client = OpenAI()
response = client.images.generate(
model="gpt-image-2.5-sunburst",
prompt="A Breton lighthouse at sunset, watercolor style",
n=1,
size="1024x1024"
)
with open("lighthouse.png", "wb") as f:
f.write(base64.b64decode(response.data[0].b64_json))
It-tieni jieħu immaġni li tipprovdi int u jerġa’ jiġġenera biss il-parti indikata minn maskra.
response = client.images.edit(
model="gpt-image-2.5-sunburst",
image=open("original_photo.png", "rb"),
mask=open("mask.png", "rb"),
prompt="Replace the sky with a starry sky"
)
Installazzjoni u Konfigurazzjoni
L-ewwel installa s-SDK uffiċjali.
pip install openai
Sussegwentement, poġġi ċ-ċavetta tal-API tiegħek f’fajl .env, qatt mhux imwaħħla direttament (hard-coded) fl-iskritt tiegħek: skritt maqsum jew wieħed imbuttat lejn repository jesponi ċ-ċavetta tiegħek.
OPENAI_API_KEY=sk-your-api-key
Il-klijent imbagħad jirkuprah awtomatikament mal-bidu, mingħajr ma jkollok tgħaddih bħala argument.
import os
from dotenv import load_dotenv
from openai import OpenAI
load_dotenv()
client = OpenAI() # jużaw awtomatikament OPENAI_API_KEY
Il-Mudell u l-Prezzijiet
Il-mudelli attwali huma gpt-image-2.5-sunburst, l-aktar preċiż għall-editjar, u gpt-image-2.5-flare, aktar mgħaġġel għall-ġenerazzjoni standard; gpt-image-1, il-mudell li għalih kien miktub oriġinarjament dan il-kors, ġie interrott fit-23 ta’ Ottubru, 2026. Hawnhekk huma l-karatteristiċi li se tittratta kontinwament.
| Parametru | Valur |
|---|---|
| Mudell | gpt-image-2.5-sunburst jew gpt-image-2.5-flare |
| Riżoluzzjonijiet | 1024×1024, 1024×1536, 1536×1024 rakkomandati; dimensjonijiet personalizzati possibbli (multipli ta’ 16, sa 3840 pixel fuq kull naħa) |
| Kwalitajiet | low, medium, high, xhigh, max, auto (default) |
| Formati tal-Output | Immaġni kodifikata f’Base64, PNG (default), JPEG, jew WebP |
| Prezzijiet | Għal kull token, ivarja skont il-kwalità u d-daqs |
Żomm f’moħħok punt wieħed li jissorprendi l-veterani ta’ DALL·E: il-mudelli GPT Image qatt ma jirritornaw URL, dejjem immaġni kodifikata f’base64. Iddekodifikaha u ssalva l-fajl immedjatament wara l-ġenerazzjoni; l-applikazzjoni tiegħek taħżen u sservi dan il-fajl, mhux ir-risposta tal-API.
X’Se Titgħallem
Il-kors jimxi ‘l quddiem f’erba’ stadji. Tibda bil-fundamentali ta’ GPT Image permezz tal-API—il-ġenerazzjoni u l-editjar—qabel ma tgħaddi għal każijiet ta’ użu konkreti fl-e-commerce, il-marketing, u d-disinn. Tekniki avvanzati mbagħad jgħallmuk kif tibni prompts viżwali kumplessi u tintegra l-ġenerazzjoni f’pajplines ta’ għodod multipli. Il-parti finali tkopri d-dispiegħ fil-produzzjoni, inkluż l-ottimizzazzjoni tal-ispejjeż u l-moderazzjoni tal-kontenut. Kull lezzjoni fiha kodiċi Python funzjonali li tista’ tħaddem direttament.
Qabel ma tmur ‘il quddiem, ivverifika li l-ambjent tiegħek huwa lest. Ħaddem dan l-iskritt minimu: jekk jidher fajl tal-immaġni, iċ-ċavetta tiegħek hija valida, l-SDK huwa installat korrettament, u tista’ tipproċedi għal-lezzjoni li jmiss.
import base64
from openai import OpenAI
client = OpenAI()
response = client.images.generate(
model="gpt-image-2.5-sunburst",
prompt="A ginger cat sitting on a pile of books, realistic photo",
n=1,
size="1024x1024",
quality="medium"
)
with open("cat.png", "wb") as f:
f.write(base64.b64decode(response.data[0].b64_json))
print("Image generated: cat.png")