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

Oħloq stampi minn prompt

Lezzjoni 2 / 12 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Oħloq stampi minn prompt
  2. Anatomija ta’ sejħa ta’ ġenerazzjoni
  3. Irkupra l-immaġni ġġenerata
  4. Iġġenera immaġni multipli f’sejħa waħda
  5. Ikteb prompts effettivi
  6. Ġestjoni tal-iżbalji

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 fl-23 ta’ Ottubru, 2026. 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-ogħla 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 is-settings tal-kwalità xhigh u max. Il-mudelli GPT Image dejjem jirritornaw l-immaġni f’base64: il-parametru response_format użat mill-mudelli DALL·E eqdem mhuwiex appoġġjat u tneħħa mill-kodiċi. Sors: Image generation (OpenAI).

Oħloq stampi minn prompt

Il-metodu client.images.generate() huwa l-punt tad-dħul primarju tiegħek biex toħloq immaġni minn deskrizzjoni testwali. Jiddependi fuq ftit parametri biss, iżda preċiżament għaliex hemm daqshekk ftit, kull wieħed minnhom jgħodd: id-differenza bejn riżultat każwali u wieħed prevedibbli tiddependi kważi għalkollox fuq il-kontenut tal-kamp prompt. Din il-lezzjoni tgħallek titgħallem it-tnejn.

Anatomija ta’ sejħa ta’ ġenerazzjoni

Hawnhekk hija l-istruttura sħiħa ta’ sejħa bil-parametri disponibbli kollha.

from openai import OpenAI

client = OpenAI()

response = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="Deskrizzjoni dettaljata tal-immaġni mixtieqa",
    n=1,
    size="1024x1024",
    quality="high"
)
ParametruTipDeskrizzjoni
modelstring"gpt-image-2.5-sunburst" (l-aktar preċiż) jew "gpt-image-2.5-flare" (l-aktar mgħaġġel)
promptstringDeskrizzjoni tal-immaġni (sa 32,000 karattru)
nintegerNumru ta’ immaġni li jiġu ġġenerati (1 sa 10)
sizestring"1024x1024", "1024x1536", "1536x1024"
qualitystring"low", "medium", "high"

Il-limitu ta’ 32,000 karattru għall-prompt huwa ġeneruż: jippermetti deskrizzjonijiet ferm dettaljati, u se tara ftit li d-dettall huwa l-aħjar leva tiegħek għall-kontroll.

Irkupra l-immaġni ġġenerata

Ir-risposta fiha oġġett data li fih l-immaġni. Il-mudelli GPT Image dejjem jirritornaw l-immaġni kodifikata f’base64 fil-kamp b64_json: inti tiddikodifikaha u tiktebha fuq id-disk immedjatament. Il-parametru response_format u l-URLs temporanji mill-mudelli DALL·E eqdem ma japplikawx għal GPT Image.

import base64

response = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="Ġarden Ġappuniż fix-xita, fotografija",
    n=1,
    size="1024x1024",
)

image_data = base64.b64decode(response.data[0].b64_json)

with open("garden.png", "wb") as f:
    f.write(image_data)

print("Immaġni salvata: garden.png")

Ladarba l-fajl jiġi miktub, xejn ma jiddependi aktar fuq OpenAI: dan huwa l-fajl li taħżen, isservi, jew terġa’ taħdem fuqu.

Iġġenera immaġni multipli f’sejħa waħda

Il-parametru n jitlob varjanti multipli f’talba waħda. Agħmel dan ir-rifless default tiegħek meta tkun qed tesplora direzzjoni viżiva mingħajr ma tkun taf liema waħda se żżomm: erba’ proposti ħdejn xulxin jinfurmawk ferm aħjar minn waħda waħda.

import base64
response = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="Logo minimalistu għal ħobż tal-artiġjanat, sfond abjad",
    n=4,
    size="1024x1024",
    quality="high"
)

for i, image in enumerate(response.data):
    with open(f"logo_{i+1}.png", "wb") as f:
        f.write(base64.b64decode(image.b64_json))
    print(f"Varjant {i+1}: logo_{i+1}.png")

Madankollu, ara l-ispejjeż tiegħek: kull immaġni tikkonsma tokens indipendentement, u l-ġenerazzjoni ta’ 4 immaġni tispiċċa 4 darbiet l-ispiża ta’ waħda waħda. Esplora b’n għoli u kwalità baxxa, u rriżerva l-kwalità għolja għas-selezzjoni finali.

Ikteb prompts effettivi

Il-kwalità tar-riżultat tiddependi direttament mill-preċiżjoni tal-prompt tiegħek. Prompt tajjeb isegwi struttura sempliċi—suġġett + stil + kuntest + dettalji tekniċi—u t-tqabbil hawn taħt jagħmel id-differenza tanġibbli: “dar” iħalli lill-mudell jinventa kollox li ma għidtx, filwaqt li l-verżjoni żviluppata tiffissa l-materjal, il-kulur tal-persjani, il-ħin tal-ġurnata, ir-reġistru editorjali, u t-trattament ottiku.

# Prompt vagu — riżultat imprevedibbli
weak_prompt = "dar"

# Prompt strutturat — riżultat ikkontrollat
strong_prompt = (
    "Dar tal-kampanja Provenzali bil-ġebel bjond, "
    "persjani blu lavanda, lidra fuq il-faċċata, "
    "fotografata fil-ħin tad-deheb, "
    "stil editorjali għal rivista tal-arkitettura, "
    "kompożizzjoni ċċentrata, fond tal-kamp"
)

response = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt=strong_prompt,
    size="1536x1024",
    quality="high"
)

Iddikjara l-istil viżiv bl-istess mod, billi tsemmi mezz pjuttost milli tama f’intenzjoni. GPT Image jifhem firxa wiesgħa ta’ reġistri, u ċ-ċiklu li ġej jħallik tħoss il-firda bejniethom fuq suġġett strettament identiku: iċ-ċiklu quddiem il-kafetterija Pariġina tinbidel kompletament fin-natura tagħha skont jekk titlobx fotografija editorjali, illustrazzjoni vettorjali ċatta, jew skizz bil-lapes.

import base64
styles = [
    "fotografija editorjali, dawl tal-istudjo",
    "illustrazzjoni vettorjali ta' disinn ċatt",
    "akwarel fuq karta minsuġa",
    "render 3D fotorealistiku, Octane Render",
    "skizz bil-lapes fuq karta kraft",
]

for style in styles:
    prompt = f"Ċiklu antik ipparkjat quddiem kafetterija Pariġina, {style}"
    response = client.images.generate(
        model="gpt-image-2.5-sunburst",
        prompt=prompt,
        size="1024x1024",
        quality="medium"
    )
    filename = f"bicycle_{styles.index(style) + 1}.png"
    with open(filename, "wb") as f:
        f.write(base64.b64decode(response.data[0].b64_json))
    print(f"Stil: {style} → {filename}")

It-test inkorporat fl-immaġni jistħoqqilu nota separata, peress li hawnhekk GPT Image jiddistingwi ruħu b’mod ċar mill-predeċessuri tiegħu. Agħti l-messaġġ bejn virgoli fil-prompt, speċifika l-familja tat-tipa u t-trattament grafiku mistenni, u r-riżultat ikun leġibbli.

response = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt=(
        "Poster promozzjonali bit-test \"SUMMER SALE -50%\" "
        "f'ittri kbar bojod fuq sfond gradjent blu-oranġjo, "
        "tipografija sans-serif moderna, stil kummerċjali professjonali"
    ),
    size="1024x1536",
    quality="high"
)

Ġestjoni tal-iżbalji

Skript ta’ ġenerazzjoni li jgħaddi minn ċiklu eventwalment se jilħaq limitu ta’ rata jew jiġi f’żball tal-API. Iġġesti dawn iż-żewġ każijiet b’mod distint mill-bidu nett: RateLimitError jeħtieġ stennija u tentattiv mill-ġdid, filwaqt li APIError jeħtieġ eżami tal-messaġġ qabel ma terġa’ tniedi xejn.

import base64
from openai import OpenAI, APIError, RateLimitError

client = OpenAI()

try:
    response = client.images.generate(
        model="gpt-image-2.5-sunburst",
        prompt="Pajsaġġ ta' muntanja bil-borra fix-xemx tibżiegħ",
        size="1024x1024"
    )
    with open("mountain.png", "wb") as f:
        f.write(base64.b64decode(response.data[0].b64_json))

except RateLimitError:
    print("Limitu tat-talbiet milħuq. Stenna qabel ma terġa' tipprova.")

except APIError as e:
    print(f"Żball tal-API: {e.message}")

Biex tirranġa dan kollu, issa ikteb skript li jiġġenera tliet varjanti tal-istess suġġett fi tliet stili differenti—fotografija, illustrazzjoni, akwarel—u jsalva kull immaġni lokalment f’format PNG, billi tuża l-format base64 għall-irkupru.