Parametru d-dettall: auto, low, u high
F'din il-paġna
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
detailjikkontrolla l-fond tal-analiżi tal-immaġni auto(predefinit) iħalli lill-mudell jiddeċiedi—din hija l-għażla rrakkomandatalowhuwa mgħaġġel u ekonomiku, adattat għal kompiti ta’ klassifikazzjonihighhuwa 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ż