Endpoint /v1/images/edits: Iddita l-Immaġnijiet Tiegħek
F'din il-paġna
Aġġornat fit-2 ta’ Novembru, 2026 — Imagine.
grok-imagine-image-qualitytneħħa fit-2 ta’ Novembru, 2026 (it-talbiet tiegħu issa jiġu sserviti minn Imagine 2.0 bil-kwalitàlow): l-eżempji issa jużawgrok-imagine-image(Imagine 1.0) ugrok-imagine-image-2.0(Imagine 2.0, bil-kwalitàlow,medium, jewauto). Mas-SDK ta’ OpenAI,aspect_ratio,resolution, uqualityjgħaddu minnextra_body, filwaqt li l-editjar juża s-SDK ta’ xAI jew talba HTTP.
L-Editjar tal-Immaġnijiet bl-API ta’ Grok
Barra mill-ġenerazzjoni, l-API ta’ xAI toffri endpoint iddedikat biex tiddita immaġnijiet eżistenti: POST /v1/images/edits. Dan l-endpoint jippermettilek timmodifika, tittrasforma, jew ittejjeb l-immaġnijiet billi tiddeskrivi l-bidliet mixtieqa f’prompt sempliċi tat-test.
L-Istruttura tat-Talba tal-Editjar
L-editjar jaħdem bħall-ġenerazzjoni, b’differenza waħda li tbiddel kollox dwar kif tikteb il-prompts: il-prompt jiddeskrivi l-modifika, mhux l-immaġni finali. “Mara bin-nuċċalijiet tax-xemx” tiġġenera mill-ġdid immaġni sħiħa; “żid nuċċalijiet tax-xemx” iżżomm ir-ritratt u tintervjeni biss fuq dak il-punt. Din hija l-konfużjoni l-aktar komuni fl-ewwel tentattiv, u tispjega l-biċċa l-kbira tar-riżultati deludenti.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Żid kappell aħmar lill-karattru",
"image": {
"url": "https://exemple.com/photo-personnage.jpg"
}
}
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
result = response.json()
edited_url = result["data"][0]["url"]
Għaliex Tuża requests Minflok l-SDK ta’ OpenAI?
Hawnhekk insibu l-insidja teknika ta’ din il-lezzjoni, u trid tkun taf dan qabel ma titlef siegħa fuqu: il-kompatibbiltà mal-SDK ta’ OpenAI, li taħdem perfettament għall-ġenerazzjoni, tieqaf fl-editjar. L-endpoint tal-editjar ta’ xAI juża format JSON, filwaqt li l-metodu images.edit() tal-SDK jibgħat multipart/form-data. Din l-inkompatibbiltà fit-tip ta’ kontenut tfisser li trid tuża l-API REST direttament bil-librerija requests għall-editjar.
# MA JAĦDIMX mal-API ta' xAI
# client.images.edit(...) # Jibgħat multipart, mhux JSON
# JAĦDEM: sejħa REST diretta
requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
Il-Parametri tal-Endpoint tal-Editjar
model(meħtieġ):grok-imagine-image(Imagine 1.0) jewgrok-imagine-image-2.0(Imagine 2.0, li jaċċetta wkollquality)prompt(meħtieġ): deskrizzjoni tal-modifika li għandha tiġi applikataimage: oġġett li fih l-URL ta’ immaġni sors waħdaimages: array ta’ oġġetti għal immaġnijiet sors multipli (esklussiv reċiprokament ma’image)mask: oġġett li fih l-URL tal-maskra taż-żona li għandha tiġi editjatan: numru ta’ varjanti li għandhom jiġu ġġenerati (minn 1 sa 10)response_format:urljewb64_json
Tipi ta’ Editjar Possibbli
Il-ħames familji hawn taħt ma jaqsmux l-istess rata ta’ suċċess, u jgħin li tkun taf dan qabel ma twiegħed riżultat. Iż-żieda ta’ elementi u l-bidla fl-atmosfera jaħdmu tajjeb ħafna għax jiddependu fuq kontenut eżistenti. It-tneħħija hija aktar diffiċli—il-mudell irid jirrikostruwixxi x’kien hemm wara l-element imneħħi—u hawnhekk fejn il-maskra ssir essenzjali, billi tiddefinixxi preċiżament iż-żona li għandha tiġi kkalkulata mill-ġdid.
- Żieda ta’ elementi: “Żid nuċċalijiet tax-xemx lill-karattru”
- Tneħħija: “Neħħi l-isfond u ibdlu b’isfond abjad”
- Trasformazzjoni tal-istil: “Ikkonverti dan ir-ritratt f’illustrazzjoni bl-akwarell”
- Modifika tal-atmosfera: “Ibdel ix-xena minn nhar għal lejl”
- Korrezzjoni: “Tejjeb id-dawl u żid il-kuntrast”
# Eżempju: ibdel l-istil ta' immaġni
payload = {
"model": "grok-imagine-image",
"prompt": "Trasforma dan ir-ritratt f'illustrazzjoni bl-istil tal-komiks Franko-Belġjan",
"image": {
"url": "https://exemple.com/photo-ville.jpg"
}
}
Prattika Manwali
Ipprova tiddita immaġni f’diversi passi. Ibda b’modifika sempliċi, imbagħad irfina:
# Pass 1: immodifika l-isfond
payload_step1 = {
"model": "grok-imagine-image",
"prompt": "Ibdel l-isfond b'nixxigħa fuq l-oċean",
"image": {"url": "https://exemple.com/portrait.jpg"}
}
Punti Ewlenin
- L-endpoint tal-editjar huwa
POST /v1/images/edits - Uża
requestsf’Python, mhux l-SDK ta’ OpenAI (inkompatibbiltà tal-format) - Tista’ tipprovdi sa 5 immaġnijiet sors għal kull talba
- Il-prompt jiddeskrivi l-modifika mixtieqa b’lingwa naturali
- Iż-żewġ mudelli (Imagine 1.0 u Imagine 2.0) huma disponibbli għall-editjar; mas-SDK ta’ OpenAI,
images.edit()mhix appoġġjata minn xAI: uża s-SDK ta’ xAI jew talba HTTP