Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Endpoint /v1/images/edits: Iddita l-Immaġnijiet Tiegħek

Lezzjoni 5 / 14 Aġġornat 2 ta’ Novembru 2026 Bidbieni
F'din il-paġna
  1. L-Editjar tal-Immaġnijiet bl-API ta’ Grok
  2. L-Istruttura tat-Talba tal-Editjar
  3. Għaliex Tuża requests Minflok l-SDK ta’ OpenAI?
  4. Il-Parametri tal-Endpoint tal-Editjar
  5. Tipi ta’ Editjar Possibbli
  6. Prattika Manwali
  7. Punti Ewlenin

Aġġornat fit-2 ta’ Novembru, 2026 — Imagine. grok-imagine-image-quality tneħħ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żaw grok-imagine-image (Imagine 1.0) u grok-imagine-image-2.0 (Imagine 2.0, bil-kwalità low, medium, jew auto). Mas-SDK ta’ OpenAI, aspect_ratio, resolution, u quality jgħaddu minn extra_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.

5
Massimu ta' immaġnijiet sors
2
Formati tal-input
JSON
Content-Type meħtieġ
∞
Rawnds ta' editjar

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) jew grok-imagine-image-2.0 (Imagine 2.0, li jaċċetta wkoll quality)
  • prompt (meħtieġ): deskrizzjoni tal-modifika li għandha tiġi applikata
  • image: oġġett li fih l-URL ta’ immaġni sors waħda
  • images: 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 editjata
  • n: numru ta’ varjanti li għandhom jiġu ġġenerati (minn 1 sa 10)
  • response_format: url jew b64_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 requests f’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