Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Eagarthóireacht Ilchasta agus Athdhearadh Spriocdhírithe

Ceacht 8 as 14 Nuashonraithe 3 Samhain 2026 Doicnéir
Ar an leathanach seo
  1. Eagarthóireacht a Shlabhrú
  2. Crios a Spriocdhíriú tríd an Leid
  3. Crios a Chosaint go Picteilín-bheacht: An Masc Logánta
  4. Píblíne Eagarthóireachta Iomlán
  5. Príomhphointí

Nuashonraithe an 3 Samhain, 2026. Bunaithe ar an leathanach Image Editing, ar an Image Prompting Guide, agus ar thagairt API Íomhánna xAI: níl aon pharaiméadar mask ag an bpointe deiridh /v1/images/edits—ná san tagairt ná in xai-sdk 1.21.0—contrártha don a mhaígh an leagan roimhe seo. Déantar an t-athdhearadh a spriocdhíriú tríd an leid (prompt), agus cosnaítear crios go picteilín-bheacht le masc a chuirtear i bhfeidhm go logánta, tar éis na heagarthóireachta. Foinse: Image Editing · Image Prompting Guide · Images API.

Eagarthóireacht a Shlabhrú

Bíonn eagarthóireacht íomhánna fíor-chumhachtach nuair a shlabhraíonn tú iliomad modhnuithe. Is simplí an prionsabal a mhíníonn xAI: éiríonn aschur eagarthóireachta mar ionchur don chéad cheann eile, rud a ligeann duit tosú le híomhá bhunaidh agus ansin mionsonraí a chur leis, an stíl a choigeartú, nó ceartúcháin a dhéanamh, cas ar chas.

import requests
import os

headers = {
    "Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
    "Content-Type": "application/json"
}

def edit_image(image_url, prompt):
    """Déanann sé eagarthóireacht ar íomhá agus filleann sé an URL toraidh."""
    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"]

# Cas 1: an cúlra a mhodhnú
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."
)

# Cas 2: an soilsiú a choigeartú
url_tour2 = edit_image(
    url_tour1,
    "Make the light warm and dim, like late afternoon. "
    "Keep the same person, decor, and framing."
)

# Cas 3: eilimint a chur leis
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}")

Dea-chleachtais le haghaidh Eagarthóireachta Ilchasta

Molann treoir xAI eagarthóireacht a dhéanamh nuair atá an t-ábhar agus an leagan amach maith cheana féin agus nach bhfuil gá ach le hathrú ar dtrí mhionsonra nó níos lú; má tá an t-ábhar féin mícheart, is fearr é a athghiniúint. Tosaíonn gach cas leis an modhnú, agus luaitear ansin i ngnáthamh amháin cad nach mbogann: an t-ábhar, an uillinn, an fráma, suíomh an ruda. Theipeann ar dhá fhoirmliú de réir na treorach: ceann a osclaíonn le “keep everything” (coinnigh gach rud), nach n-athraíonn beagnach aon rud, agus ceann a chóipeálann leid iomlán, a dhéanann an radharc a athchumadh—sleamhnaíonn an t-ábhar, dúbailtear rud, nó athraíonn sé ina rud comharsanach.

Cuir na casanna in ord ó ghinearálta go sonrach: cúlra, comhdhéanamh, agus atmaisféar ar dtús, ansin gabhálais agus ceartúcháin mhíne, ionas nach ndéanfaidh athrú mór déanach dochar do na hathdhearuithe beaga.

Cuireann dhá réamhchúram sábháilteachta críoch leis an modh. Íoslódáil gach toradh idirmheánach chomh luath agus a tháirgtear é: tá na URLanna sealadach, agus má chailleann tú cas 3 de shraith cúig, éigníonn sé tú tosú arís ó chas 2. Agus scrúdaigh gach céim sula ndéanann tú slabhrú: críochnaíonn locht a tugadh isteach ag cas 1—méar cam, scáth neamh-chomhsheasmhach—in gach cas ina dhiaidh sin, ós rud é go dtosaíonn gach ceann ón íomhá roimhe.

Crios a Spriocdhíriú tríd an Leid

Ní ghlacann an API le masc: is é an leid a dhéanann an spriocdhíriú. Ainmnigh an chuid le modhnú chomh beacht agus is féidir—tríd an ainm, an suíomh, an t-ábhar—agus ainmnigh cad a chaithfidh fanacht mar an gcéanna.

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."
)

Nuair nach n-éiríonn le ceartúchán, molann an treoir focail a athrú seachas an t-iarratas céanna a athdhéanamh, ag sonrú cuid na híomhá le ceartú agus cad ba chóir a bheith ann. Chun íomhánna iolracha a chur le chéile—táirge i maisiú, carachtar ó íomhá amháin go ceann eile—glacann eagarthóireacht le suas le cúig íomhá foinse (ceacht 7).

Crios a Chosaint go Picteilín-bheacht: An Masc Logánta

Má tá cuid den íomhá nach mór nach mbogfaidh picteilín amháin—lógó, aghaidh, téacs—cuir an masc i bhfeidhm go logánta, tar éis na heagarthóireachta: coinníonn tú an crios bunaidh agus tógann tú ón eagarthóireacht ach an méid atá lasmuigh den chrios seo. Le Pillow, déanann Image.composite(image1, image2, mask) cóip de image1 áit a bhfuil an masc bán agus coinníonn sé image2 áit a bhfuil sé dubh:

from PIL import Image, ImageDraw

original = Image.open("original.jpg").convert("RGB")
edite = Image.open("edite.jpg").convert("RGB").resize(original.size)

# Masc: bán = tóg an t-eagarthóireacht, dubh = coinnigh an bunús
masque = Image.new("L", original.size, 255)
draw = ImageDraw.Draw(masque)
draw.rectangle([40, 40, 360, 160], fill=0)  # crios cosanta, m.sh. lógó

resultat = Image.composite(edite, original, masque)
resultat.save("resultat.jpg")

Caithfidh an trí íomhá a bheith ar an méid céanna. Glacann athrú méide leis go gcoinnigh an eagarthóireacht cóimheas gnéithe na foinse: fíoraigh é, nó forghníomhaigh é le paraiméadar aspect_ratio an iarratais. Ní chuireann an masc cosc ar an tsamhail teagmháil a dhéanamh leis an gcrios; ligeann sé duit é a athbhunú ina dhiaidh sin.

Píblíne Eagarthóireachta Iomlán

Seo sampla de phíblíne struchtúrtha, ag coinneáil staire gach cas:

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

Príomhphointí

  • Slabhraíonn eagarthóireacht ilchasta torthaí: éiríonn gach aschur mar ionchur don chéad eagarthóireacht eile
  • Déan eagarthóireacht nuair atá an t-ábhar agus an leagan amach maith agus nach bhfuil gá ach le hathrú ar dtrí mhionsonra nó níos lú
  • Gach cas: an modhnú ar dtús, ansin cad a chaithfidh fanacht mar an gcéanna
  • Níl aon pharaiméadar mask ag an API: spriocdhírigh tríd an leid, agus cosain crios le masc logánta a chuirtear i bhfeidhm tar éis na heagarthóireachta
  • Tá URLanna aschuir sealadach: íoslódáil torthaí idirmheánacha