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

Ibbeljar fuq ħafna dawriet u retouching immirat

Lezzjoni 8 / 14 Aġġornat 3 ta’ Novembru 2026 Bidbieni
F'din il-paġna
  1. Katina ta’ Ibbljar (Chaining Edits)
  2. Immirar ta’ Żona permezz tal-Prompt
  3. Protezzjoni ta’ Żona Pixel-perfect: Il-Maskra Lokali
  4. Pipeline Sħiħa tal-Ibbljar
  5. Punti Ewlenin

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/edits m’għandux parametru mask—la fir-referenza u lanqas fl-xai-sdk 1.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