Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Paraiméadar mionsonraithe: auto, low, agus high

Ceacht 2 as 12 Nuashonraithe 30 Iúil 2026 Doicnéir
Ar an leathanach seo
  1. Cruinneas na hanailíse a rialú
  2. Na trí leibhéal mionsonraithe
  3. Na leibhéil a chur i gcomparáid
  4. Comhréir de réir API
  5. Straitéis bharrfheabhsaithe
  6. Príomhphointí

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 detail doimhneacht na hanailíse íomhá
  • Ligeann auto (réamhshocraithe) don tsamhail cinneadh – is é seo an rogha a mholtar
  • Tá low tapa agus eacnamaíoch, oiriúnach do thascanna aicmithe
  • Tá high mall 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ú