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

Editjar Multipli ta' Stampi u Referenzi

Lezzjoni 7 / 14 Aġġornat 2 ta’ Novembru 2026 Bidbieni
F'din il-paġna
  1. Ħidma b’Diversi Stampi Sors
  2. Il-Parametru images (Plural)
  3. Referenzjar tal-Istampi fil-Prompt
  4. Każijiet ta’ Użu b’Immaġnijiet Multipli
  5. Limiti u L-Aħjar Prattiki
  6. Prattika Manwali
  7. Punti Ewlenin

Aġġornat fit-2 ta’ Novembru, 2026 — Imagine. grok-imagine-image-quality tneħħ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żaw grok-imagine-image (Imagine 1.0) u grok-imagine-image-2.0 (Imagine 2.0, kwalità low, medium, jew auto). Mas-SDK ta’ OpenAI, aspect_ratio, resolution, u quality jgħ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 images jaċċetta sa 5 stampi sors f’array
  • image (singular) u images (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