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

Parametru d-dettall: auto, low, u high

Lezzjoni 2 / 12 Aġġornat 30 ta’ Lulju 2026 Bidbieni
F'din il-paġna
  1. Ikkontrolla l-preċiżjoni tal-analiżi
  2. It-tliet livelli ta’ dettall
  3. Qabbel il-livelli
  4. Sintassi skont l-API
  5. Istrateġija ta’ ottimizzazzjoni
  6. Punti Ewlenin

Ikkontrolla l-preċiżjoni tal-analiżi

Meta tibgħat immaġni lil Grok, tista’ tikkontrolla l-livell ta’ dettall tal-analiżi billi tuża l-parametru detail. Dan il-parametru jaffettwa direttament il-kwalità tar-risposta, il-ħin tal-ipproċessar, u l-konsum tat-tokens.

Huwa kruċjali li tifhem dan il-parametru biex tottimizza l-ispejjeż u taqbel il-preċiżjoni ma’ kull każ ta’ użu.

It-tliet livelli ta’ dettall

L-API ta’ xAI toffri tliet valuri għall-parametru detail:

Auto (valur predefinit)

Meta ma tispeċifikax il-parametru detail, il-mudell juża auto. Dan jevalwa awtomatikament il-livell ta’ dettall meħtieġ ibbażat fuq l-immaġni u l-prompt tiegħek.

{
  "type": "input_image",
  "image_url": "https://exemple.com/photo.jpg"
}

Dan huwa l-imġiba rrakkomandata għall-biċċa l-kbira tal-każijiet ta’ użu. Il-mudell jadatta l-istrateġija tal-analiżi tiegħu abbażi tal-kumplessità perċepita tal-immaġni u l-mistoqsija magħmula.

Low (mgħaġġel u ekonomiku)

Il-modalità low twettaq analiżi mgħaġġla tal-immaġni billi tuża inqas tokens. Din hija l-għażla ideali meta għandek bżonn fehim ġenerali mingħajr ma tidħol f’dettalji fini.

{
  "type": "input_image",
  "image_url": "https://exemple.com/photo.jpg",
  "detail": "low"
}

Każijiet ta’ użu għal low:

  • Ikklassifika l-kontenut tal-immaġni (pajsaġġ, ritratt, dokument, eċċ.)
  • Identifika s-suġġett prinċipali ta’ ritratt
  • Issortja malajr lott ta’ immaġnijiet
  • Iċċekkja jekk immaġni taqbilx ma’ kriterju sempliċi

High (bil-mod u dettaljat)

Il-modalità high timponi analiżi eżawrjenti tal-immaġni. Il-mudell jeżamina kull żona bir-riżoluzzjoni massima, li tikkonsma aktar tokens iżda tipproduċi deskrizzjonijiet ferm aktar preċiżi.

{
  "type": "input_image",
  "image_url": "https://exemple.com/photo.jpg",
  "detail": "high"
}

Każijiet ta’ użu għal high:

  • Aqra test fin f’immaġni (OCR)
  • Analizza grafiċi b’leġġendi dettaljati
  • Skopri difetti f’ritratti ta’ prodotti
  • Eżamina screenshots ta’ interfaċċi kumplessi

Qabbel il-livelli

Parametru Velocità Tokens Preċiżjoni
auto Varjabbli Varjabbli Adattiva
low Mgħaġġla Inqas tokens Ġenerali
high Bil-mod Aktar tokens Dettaljata

Sintassi skont l-API

Il-parametru detail jitpoġġa f’postijiet differenti skont l-API użata.

Responses API (rrakkomandata)

response = client.responses.create(
    model="grok-4.5",
    input=[
        {
            "type": "input_image",
            "image_url": "https://exemple.com/photo.jpg",
            "detail": "high"
        },
        {
            "type": "input_text",
            "text": "Read all visible text in this image."
        }
    ]
)

Chat Completions API (antika)

response = client.chat.completions.create(
    model="grok-4.5",
    messages=[{
        "role": "user",
        "content": [
            {
                "type": "image_url",
                "image_url": {
                    "url": "https://exemple.com/photo.jpg",
                    "detail": "high"
                }
            },
            {
                "type": "text",
                "text": "Read all visible text in this image."
            }
        ]
    }]
)

Innota li fil-Chat Completions, detail huwa mbejjat ġewwa l-oġġett image_url, filwaqt li fir-Responses API huwa fl-istess livell bħal image_url.

Istrateġija ta’ ottimizzazzjoni

Fil-produzzjoni, prattika tajba hija li tadatta l-livell ta’ dettall abbażi tat-tip ta’ kompitu:

def analyser_image(image_url, tache):
    # Simple tasks → low to save costs
    if tache in ["classifier", "trier", "identifier_sujet"]:
        detail = "low"
    # Complex tasks → high for precision
    elif tache in ["ocr", "graphique", "defaut_produit"]:
        detail = "high"
    # Default → let the model decide
    else:
        detail = "auto"

    return client.responses.create(
        model="grok-4.5",
        input=[
            {"type": "input_image", "image_url": image_url, "detail": detail},
            {"type": "input_text", "text": f"Task: {tache}"}
        ]
    )

Dan l-approċċ jippermettilek tnaqqas b’mod sinifikanti l-ispejjeż tat-tokens fuq kompiti sempliċi filwaqt li żżomm il-preċiżjoni massima fejn meħtieġ.

Punti Ewlenin

  • Il-parametru detail jikkontrolla l-fond tal-analiżi tal-immaġni
  • auto (predefinit) iħalli lill-mudell jiddeċiedi—din hija l-għażla rrakkomandata
  • low huwa mgħaġġel u ekonomiku, adattat għal kompiti ta’ klassifikazzjoni
  • high huwa bil-mod iżda preċiż, adattat għal OCR u analiżi fina
  • Adatta l-livell ta’ dettall għat-tip ta’ kompitu biex tottimizza l-ispejjeż