Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

L-API ta' Ġenerazzjoni tal-Immaġni fl-2026

Lezzjoni 1 / 12 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. L-API ta’ Ġenerazzjoni tal-Immaġni fl-2026
  2. X’Jibdel GPT Image
  3. Iż-Żewġ Endpoints Prinċipali
  4. Installazzjoni u Konfigurazzjoni
  5. Il-Mudell u l-Prezzijiet
  6. X’Se Titgħallem

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, u chatgpt-image-latest se jiġu rtirati fl-1 ta’ Diċembru, 2026. L-eżempji issa jużaw gpt-image-2.5-sunburst, li joffri l-aktar preċiżjoni għall-editjar; gpt-image-2.5-flare huwa aktar mgħaġġel għall-ġenerazzjoni standard. Iż-żewġ mudelli jappoġġjaw ukoll il-kwalitajiet xhigh u max. Il-mudelli GPT Image dejjem jirritornaw immaġni f’base64: il-parametru response_format minn 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.

ParametruValur
Mudellgpt-image-2.5-sunburst jew gpt-image-2.5-flare
Riżoluzzjonijiet1024×1024, 1024×1536, 1536×1024 rakkomandati; dimensjonijiet personalizzati possibbli (multipli ta’ 16, sa 3840 pixel fuq kull naħa)
Kwalitajietlow, medium, high, xhigh, max, auto (default)
Formati tal-OutputImmaġni kodifikata f’Base64, PNG (default), JPEG, jew WebP
PrezzijietGħ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")