Eagarthóireacht Ilchasta agus Athdhearadh Spriocdhírithe
Ar an leathanach seo
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
maskag an bpointe deiridh/v1/images/edits—ná san tagairt ná inxai-sdk1.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
maskag 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