Paraiméadar mionsonraithe: auto, low, agus high
Ar an leathanach seo
Cruinneas na hanailíse a rialú
Nuair a sheolann tú íomhá chuig Grok, is féidir leat leibhéal mionsonraithe na hanailíse a rialú leis an bparaiméadar detail. Baineann an paraiméadar seo go díreach le cáilíocht na freagartha, an t-am próiseála, agus an tomhaltas tocainí.
Tá sé ríthábhachtach an paraiméadar seo a thuiscint chun costais a bharrfheabhsú agus an chruinneas a oiriúnú do gach cás úsáide.
Na trí leibhéal mionsonraithe
Tairgeann API xAI trí luach don pharaiméadar detail:
Auto (an luach réamhshocraithe)
Mura sonraíonn tú an paraiméadar detail, úsáideann an tsamhail auto. Déanann sí meastóireacht uathoibríoch ar an leibhéal mionsonraithe is gá bunaithe ar an íomhá agus ar do leid.
{
"type": "input_image",
"image_url": "https://exemple.com/photo.jpg"
}
Seo an iompar a mholtar don chuid is mó de chásanna úsáide. Oiriúnaíonn an tsamhail a straitéis anailíse de réir castacht mheasta na híomhá agus na ceiste a chuirtear.
Low (tapa agus eacnamaíoch)
Déanann an mód low anailís ghairid ar an íomhá ag baint úsáide as níos lú tocainí. Is é seo an rogha idéalach nuair a theastaíonn tuiscint ghinearálta uait gan dul i mbun mionsonraí.
{
"type": "input_image",
"image_url": "https://exemple.com/photo.jpg",
"detail": "low"
}
Cásanna úsáide do low:
- Ábhar na híomhá a aicmiú (tírdhreach, portráid, doiciméad, srl.)
- Príomhábhar grianghraif a aithint
- Baisc íomhánna a shórtáil go tapa
- Seiceáil an bhfuil íomhá ag teacht le critéar simplí
High (mall agus mionsonraithe)
Cuirfidh an mód high anailís iomlán ar an íomhá i bhfeidhm. Scrúdaíonn an tsamhail gach cearn ag an taifeach is airde, rud a ídíonn níos mó tocainí ach a tháirgeann cur síos i bhfad níos cruinne.
{
"type": "input_image",
"image_url": "https://exemple.com/photo.jpg",
"detail": "high"
}
Cásanna úsáide do high:
- Téacs mín in íomhá a léamh (OCR)
- Cairteacha le finscéalta mionsonraithe a anailísiú
- Easnamh i ngrianghraif táirgí a bhrath
- Scáileáin ghreata de chomhéadain chasta a scrúdú
Na leibhéil a chur i gcomparáid
| Paraiméadar | Luas | Tocainí | Cruinneas |
|---|---|---|---|
| auto | Inathraithe | Inathraithe | Oiriúnaitheach |
| low | Tapa | Níos lú tocainí | Ginearálta |
| high | Mall | Níos mó tocainí | Mionsonraithe |
Comhréir de réir API
Cuirtear an paraiméadar detail in áiteanna éagsúla ag brath ar an API a úsáidtear.
Responses API (moltar)
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 (leagan níos sine)
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."
}
]
}]
)
Tabhair faoi deara go bhfuil detail neadaithe laistigh den oibiacht image_url i gChat Completions, cé go bhfuil sé ar an leibhéal céanna le image_url sa Responses API.
Straitéis bharrfheabhsaithe
Sa táirgeadh, is dea-chleachtas é an leibhéal mionsonraithe a oiriúnú de réir chineál na tasc:
def analyser_image(image_url, tache):
# Tascanna simplí → low chun costais a shábháil
if tache in ["classifier", "trier", "identifier_sujet"]:
detail = "low"
# Tascanna casta → high don chruinneas
elif tache in ["ocr", "graphique", "defaut_produit"]:
detail = "high"
# Réamhshocrú → lig don tsamhail cinneadh
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}"}
]
)
Ligeann an cur chuige seo duit costais tocainí a laghdú go suntasach ar thascanna simplí agus an chruinneas uasta a choinneáil san áit a bhfuil gá leis.
Príomhphointí
- Rialaíonn an paraiméadar
detaildoimhneacht na hanailíse íomhá - Ligeann
auto(réamhshocraithe) don tsamhail cinneadh – is é seo an rogha a mholtar - Tá
lowtapa agus eacnamaíoch, oiriúnach do thascanna aicmithe - Tá
highmall ach cruinn, oiriúnach do OCR agus d’anailís mhín - Oiriúnaigh an leibhéal mionsonraithe do chineál an tasc chun costais a bharrfheabhsú