Editjar Multipli ta' Stampi u Referenzi
F'din il-paġna
Aġġornat fit-2 ta’ Novembru, 2026 — Imagine.
grok-imagine-image-qualitytneħħa mill-2 ta’ Novembru, 2026 (it-talbiet issa jiġu pproċessati minn Imagine 2.0 fil-kwalitàlow): l-eżempji issa jużawgrok-imagine-image(Imagine 1.0) ugrok-imagine-image-2.0(Imagine 2.0, kwalitàlow,medium, jewauto). Mas-SDK ta’ OpenAI,aspect_ratio,resolution, uqualityjgħaddu permezz ta’extra_body, filwaqt li l-editjar jiġi ġestit permezz tas-SDK ta’ xAI jew talba HTTP.
Ħidma b’Diversi Stampi Sors
Waħda mill-forzi tal-endpoint tal-editjar hija l-kapaċità li tipprovdi sa 5 stampi ta’ referenza f’talba waħda. Dan jiftaħ possibbiltajiet kreattivi avvanzati: tgħaqqad elementi minn sorsi multipli, tħallat stili, jew toħloq kompożizzjonijiet kumplessi.
Il-Parametru images (Plural)
Il-bidla minn image għal images tbiddel aktar mill-forma tal-parametru: tbiddel x’t qed titlob lill-mudell jagħmel. B’sors wieħed, jimmodifika stampa; b’diversi, irid jarbitra bejniethom—jiddeċiedi x’jieħu minn kull waħda. Se jarbitra xorta waħda; l-unika mistoqsija hija jekk tiddireġixxix dak il-proċess, li huwa l-fokus tat-taqsima li jmiss.
Innota li ż-żewġ parametri huma esklużivi reċiprokament: image (oġġett wieħed) u images (array) ma jistgħux jiġu kkombinati.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Għaqqad il-karattru mill-ewwel stampa mal-"
"pajsaġġ mit-tieni stampa",
"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()
Referenzjar tal-Istampi fil-Prompt
Meta tipprovdi stampi multipli, tista’ tirreferenzjahom individwalment fil-prompt tiegħek bl-użu tas-sintassi <IMAGE_0>, <IMAGE_1>, eċċ. L-indiċi jibda minn 0.
payload = {
"model": "grok-imagine-image",
"prompt": "Poġġi l-prodott minn <IMAGE_0> fuq il-mejda minn <IMAGE_1>, "
"bid-dawl ambjentali minn <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>
]
}
Din is-sintassi hija dak li jiddistingwi kompożizzjoni kkontrollata minn taħlita approssimattiva. “Għaqqad dawn l-istampi” iħalli kollox f’idejn il-mudell; “poġġi l-prodott minn <IMAGE_0> fl-ambjent ta’ <IMAGE_1> waqt li żżomm id-dawl minn <IMAGE_1>” ma jħalli l-ebda spazju għal interpretazzjoni. Hekk kif tipprovdi aktar minn sors wieħed, irreferenzjahom b’mod espliċitu.
Każijiet ta’ Użu b’Immaġnijiet Multipli
Trasferiment tal-Istil
Applika l-istil ta’ stampa ta’ referenza għal oħra:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Irriproduċi l-kontenut ta' <IMAGE_0> fl-istil artistiku ta' <IMAGE_1>",
"images": [
{"url": "https://exemple.com/photo-originale.jpg"},
{"url": "https://exemple.com/reference-style.jpg"}
]
}
Kompożizzjoni tal-Prodott
Integra prodott f’ambjent b’dawl ta’ referenza:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Iffotografja l-prodott minn <IMAGE_0> imqiegħed fuq l-għamara minn <IMAGE_1> "
"fil-kamra minn <IMAGE_2>, b'dawl naturali konsistenti",
"images": [
{"url": "https://exemple.com/produit-detouré.png"},
{"url": "https://exemple.com/meuble.jpg"},
{"url": "https://exemple.com/piece.jpg"}
]
}
Fużjoni tal-Wiċċ u l-Isfond
Għaqqad ritratt ma’ sfond speċifiku:
payload = {
"model": "grok-imagine-image",
"prompt": "Poġġi l-persuna minn <IMAGE_0> quddiem il-bini minn <IMAGE_1>, "
"waqt li żżomm id-dawl naturali u l-prospettiva",
"images": [
{"url": "https://exemple.com/portrait.jpg"},
{"url": "https://exemple.com/batiment.jpg"}
]
}
Limiti u L-Aħjar Prattiki
Il-limitu tekniku huwa 5 stampi għal kull talba, u tista’ tħallat liberament il-formati—xi sorsi bħala URLs, oħrajn bħala Base64—fl-istess array. Id-diffikultà reali mhix hemm: tinsab fil-preċiżjoni tal-prompt, li trid tikber man-numru ta’ stampi. B’żewġ sorsi, “għaqqad il-karattru u l-ambjent” spiss ikun biżżejjed; b’ħamsa, il-mudell ma jistax jissoponi liema element għandu jieħu minn liema stampa, u dan huwa eżattament ir-rwol tar-referenzi <IMAGE_1> sa <IMAGE_5>: “poġġi l-logo minn <IMAGE_2> fuq il-flokk tal-karattru minn <IMAGE_1>, fl-ambjent tad-dawl ta’ <IMAGE_3>” ma jħalli l-ebda ambigwità. Għal kompożizzjonijiet kumplessi b’sorsi multipli, il-mudell pro (grok-imagine-image-quality) jiġġustifika l-ispiża żejda tiegħu: dan huwa preċiżament fejn id-differenza mal-mudell standard hija l-aktar viżibbli, fil-konsistenza bejn elementi eteroġenji.
Prattika Manwali
Ipprova tgħaqqad żewġ stampi li għandek fuq idejk:
payload = {
"model": "grok-imagine-image",
"prompt": "Oħloq xena fejn l-oġġett minn <IMAGE_0> jgħum fis-sema minn <IMAGE_1>, "
"b'sstil surrealist",
"images": [
{"url": "URL_OF_YOUR_FIRST_IMAGE"},
{"url": "URL_OF_YOUR_SECOND_IMAGE"}
],
"n": 3
}
Iġġenera 3 varjazzjonijiet biex tqabbel l-interpretazzjonijiet tal-mudell.
Punti Ewlenin
- Il-parametru
imagesjaċċetta sa 5 stampi sors f’array image(singular) uimages(plural) huma esklużivi reċiprokament- Is-sintassi
<IMAGE_0>,<IMAGE_1>tippermettilek tirreferenzja kull stampa fil-prompt - Il-każijiet ta’ użu jinkludu t-trasferiment tal-istil, il-kompożizzjoni u l-fużjoni
- Kun preċiż fil-prompt tiegħek meta tuża sorsi multipli