Eagarthóireacht Il-Íomhá agus Tagairtí
Ar an leathanach seo
Nuashonraithe an 2 Samhain, 2026 — Imagine. Baineadh
grok-imagine-image-qualityamhail ón 2 Samhain, 2026 (déileáiltear le hiarratais anois ag Imagine 2.0 i gcáilíochtlow): úsáideann na samplaí anoisgrok-imagine-image(Imagine 1.0) agusgrok-imagine-image-2.0(Imagine 2.0, cáilíochtlow,medium, nóauto). Leis an OpenAI SDK, seachadtaraspect_ratio,resolution, agusqualitytríextra_body, agus déileáiltear le heagarthóireacht trí xAI SDK nó iarratas HTTP.
Ag Obair le Múltiple Íomhánna Foinse
Ceann de neartanna an phointe deiridh eagarthóireachta ná an cumas suas le 5 íomhá thagartha a sholáthar in aon iarratas amháin. Osclaíonn sé seo féidearthachtaí cruthaitheacha casta: eilimintí a chomhcheangal ó fhoinsí iolracha, stíleanna a mheascadh, nó comhdhéanamh casta a chruthú.
An Paraiméadar images (Iolra)
Nuair a athraíonn tú ó image go images, athraíonn sé níos mó ná cruth an pharaiméadair: athraíonn sé an rud a iarrann tú ar an tsamhail a dhéanamh. Le foinse amháin, déanann sí modhnú ar íomhá; le hiolra, caithfidh sí idirghabháil eatarthu — a chinneadh cad a thógáil ó gach ceann. Déanfaidh sí idirghabháil i gcónaí; ní haon cheist é sin. Is é an t-aon cheist ná an dtreoraíonn tú an próiseas sin, agus is é sin fócas an chéad chuid eile.
Tabhair faoi deara go bhfuil an dá pharaiméadar comheisiach: ní féidir image (aonad oibiachta) agus images (eagar) a chomhcheangal.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Combine the character from the first image with "
"the landscape from the second image",
"images": [
{"url": "https://exemple.com/personnage.jpg"},
{"url": "https://exemple.com/paysage.jpg"}
]
}
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
).json()
Íomhánna a Thagairt sa Phreabht
Nuair a sholáthraíonn tú íomhánna iolracha, is féidir leat tagairt a dhéanamh dóibh go hindibhidiúil i do phreabht ag baint úsáide as an gcomhréir <IMAGE_0>, <IMAGE_1>, srl. Tosaíonn an t-innéacs ag 0.
payload = {
"model": "grok-imagine-image",
"prompt": "Place the product from <IMAGE_0> on the table from <IMAGE_1>, "
"with the ambient lighting from <IMAGE_2>",
"images": [
{"url": "https://exemple.com/produit.jpg"}, # <IMAGE_0>
{"url": "https://exemple.com/table.jpg"}, # <IMAGE_1>
{"url": "https://exemple.com/ambiance.jpg"} # <IMAGE_2>
]
}
Is é an chomhréir seo a dhéanann idirdhealú idir comhdhéanamh rialaithe agus meascán garbh. Fágann “Combine these images” gach rud faoin tsamhail; fágann “place the product from <IMAGE_0> in the setting of <IMAGE_1> while keeping the lighting from <IMAGE_1>” aon spás le haghaidh léirmhínithe. Chomh luath agus a sholáthraíonn tú níos mó ná foinse amháin, déan tagairt shoiléir dóibh.
Cásanna Úsáide le Múltiple Íomhánna
Aistriú Stíle
Cuir stíl íomhá thagartha i bhfeidhm ar íomhá eile:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Reproduce the content of <IMAGE_0> in the artistic style of <IMAGE_1>",
"images": [
{"url": "https://exemple.com/photo-originale.jpg"},
{"url": "https://exemple.com/reference-style.jpg"}
]
}
Comhdhéanamh Táirge
Comhtháthaigh táirge i suíomh le solas tagartha:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Photograph the product from <IMAGE_0> placed on the furniture from <IMAGE_1> "
"in the room from <IMAGE_2>, consistent natural lighting",
"images": [
{"url": "https://exemple.com/produit-detouré.png"},
{"url": "https://exemple.com/meuble.jpg"},
{"url": "https://exemple.com/piece.jpg"}
]
}
Cumasc Aghaidhe agus Cúlra
Comhcheangail portráid le cúlra sonrach:
payload = {
"model": "grok-imagine-image",
"prompt": "Place the person from <IMAGE_0> in front of the building from <IMAGE_1>, "
"keeping natural lighting and perspective",
"images": [
{"url": "https://exemple.com/portrait.jpg"},
{"url": "https://exemple.com/batiment.jpg"}
]
}
Teorainneacha agus Dea-Chleachtais
Is é 5 íomhá in aghaidh an iarrtais an teorainn theicniúil, agus is féidir leat formáidí a mheascadh go saor — roinnt foinsí mar URLanna, cinn eile mar Base64 — san eagar céanna. Ní ann atá an fíordheacracht: tá sí i beachtas an phreabht, a chaithfidh fás de réir líon na n-íomhánna. Le dhá fhoinse, is minic a leor “combine the character and the setting”; le cúig cinn, ní féidir leis an tsamhail a thuairim cén eilimint a thógáil ón íomhá céanna, agus is é seo díreach ról na dtagairtí <IMAGE_1> go <IMAGE_5>: fágann “place the logo from <IMAGE_2> on the character’s t-shirt from <IMAGE_1>, in the lighting ambiance of <IMAGE_3>” gan aon débhríocht. I gcás comhdhéanamh il-fhoinse casta, tuilleann an tsamhail ghairmiúil (grok-imagine-image-quality) a costas breise: is ansin go díreach a bhíonn an bearna leis an tsamhail chaighdeánach is infheicthe, i gcomhsheasmhacht idir eilimintí heitrigineacha.
Cleachtas Praicticiúil
Bain triail as dhá íomhá atá agat a chomhcheangal:
payload = {
"model": "grok-imagine-image",
"prompt": "Create a scene where the object from <IMAGE_0> floats in the sky from <IMAGE_1>, "
"surrealist style",
"images": [
{"url": "URL_OF_YOUR_FIRST_IMAGE"},
{"url": "URL_OF_YOUR_SECOND_IMAGE"}
],
"n": 3
}
Gin 3 leagan chun léirmhínithe na samhla a chur i gcomparáid.
Príomhphointí
- Glacann an paraiméadar
imagesle suas le 5 íomhá foinse in eagar - Tá
image(uatha) agusimages(iolra) comheisiach - Ligeann an chomhréir
<IMAGE_0>,<IMAGE_1>duit tagairt a dhéanamh do gach íomhá sa phreabht - Áirítear aistriú stíle, comhdhéanamh, agus cumasc i measc na gcásanna úsáide
- Bí beacht i do phreabht nuair a úsáideann tú foinsí iolracha