Format tal-Kontenut
F'din il-paġna
Żewġ Formati ta’ Input ta’ Grok
Meta tibgħat messaġġ lil Grok, il-qasam content f’kull messaġġ jista’ jieħu waħda minn żewġ forom distinti. Li tifhem din id-distinzjoni huwa importanti għax jiddetermina x’tista’ tibgħat lill-mudell: test biss, jew taħlita ta’ test u immaġni.
Katina Semppliċi ta’ Test
L-aktar forma diretta: il-kontenut huwa katina sempliċi. Se tuża din għall-maġġoranza tal-interazzjonijiet tiegħek ibbażati fuq it-test.
{
"role": "user",
"content": "Explain the advantages of the Rust language compared to C++"
}
Dan il-format jaħdem għal kompiti purament ibbażati fuq it-test: mistoqsijiet, istruzzjonijiet, forniment ta’ data, jew talbiet ta’ ġenerazzjoni. Uża dan il-format meta ma jkollokx bżonn tinkludi elementi viżwali.
Array ta’ Oġġetti Ttipizzati
Għal talbiet multimodali (test + immaġni), Grok jaċċetta array ta’ oġġetti fejn kull element jinkludi qasam type li jindika n-natura tiegħu.
Format tal-Kompletamenti taċ-Chat (Endpoint Antik)
{
"role": "user",
"content": [
{"type": "text", "text": "Describe this user interface and suggest improvements"},
{"type": "image_url", "image_url": {"url": "https://exemple.com/screenshot.png", "detail": "high"}}
]
}
Format tar-Risposti (Endpoint Primarju)
{
"input": [
{"type": "input_text", "text": "Analyze this chart and extract the main trends"},
{"type": "input_image", "image_url": "https://exemple.com/graphique.png"}
]
}
Innota d-differenza fit-tismija bejn iż-żewġ endpoints: text u image_url għall-Kompletamenti taċ-Chat, input_text u input_image għar-Risposti.
Tagħqid ta’ Test u Immaġni
L-array ta’ oġġetti jħallik tħallat liberament it-test u l-immaġni f’kwalunkwe ordni. Tista’ tibgħat immaġni multipli fl-istess talba, b’test qabel, wara, jew bejniethom.
{
"role": "user",
"content": [
{"type": "text", "text": "Compare these two interface mockups:"},
{"type": "image_url", "image_url": {"url": "https://exemple.com/maquette-v1.png"}},
{"type": "text", "text": "Version 1 above, version 2 below:"},
{"type": "image_url", "image_url": {"url": "https://exemple.com/maquette-v2.png"}},
{"type": "text", "text": "Identify the main differences and recommend the best version."}
]
}
Sorsi ta’ Immaġni Aċċettati
Grok jaċċetta l-immaġni b’żewġ modi:
- URL Dirett: link HTTPS għall-immaġni ospitata online
- Kodifikat f’Base64: l-immaġni mdaħħla direttament fit-talba bħala URI tad-data
{"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,/9j/4AAQ..."}}
Il-format Base64 huwa utli meta l-immaġni tiegħek ma jkunux ospitati online (screenshots lokali, immaġni ġġenerati mill-applikazzjoni tiegħek).
Il-Parametru detail għall-Immaġni
Kull immaġni tista’ tirċievi parametru detail li jikkontrolla l-livell ta’ analiżi:
- auto: il-mudell jagħżel awtomatikament (imġiba predefinita)
- low: analiżi mgħaġġla u ekonomika, tikkonsma inqas tokens
- high: analiżi dettaljata, tikkonsma aktar tokens iżda taqbad dettalji fini
{"type": "image_url", "image_url": {"url": "https://...", "detail": "low"}}
Uża low għal kompiti sempliċi (klassifikazzjoni, deskrizzjoni ġenerali) u high għal analiżi preċiżi (OCR, detezzjoni ta’ dettalji, qari ta’ graffs).
Limitazzjonijiet Tekniċi
Żomm f’moħħok dawn il-limiti meta taħdem mal-immaġni:
- Daqs massimu: 20 MB għal kull immaġni
- Formati aċċettati: JPG, JPEG, PNG biss
- L-ebda limitu fuq in-numru ta’ immaġni għal kull talba
- Mudelli kompatibbli: grok-4.5 u ogħla
- L-immaġni jikkonsmaw bejn 256 u 1,792 token skont id-daqs u l-livell ta’ dettall tagħhom
Prattika Manwali
Ittestja ż-żewġ formati b’kompitu sempliċi:
Format sempliċi ta’ test:
{"role": "user", "content": "What are the 5 fundamental principles of UX design?"}
Format ta’ array (test biss, iżda strutturat):
{
"role": "user",
"content": [
{"type": "text", "text": "Context: I'm designing a mobile food delivery application."},
{"type": "text", "text": "Question: what are the 5 most important UX principles for this type of application?"}
]
}
Anke mingħajr immaġni, il-format tal-array jħallik tissepara b’mod ċar il-kuntest mill-mistoqsija, li tista’ ttejjeb ir-rilevanza tar-risposta.
Punti Ewlenin
- Il-kontenut jista’ jkun katina sempliċi (test sempliċi) jew array ta’ oġġetti (multimodali)
- Il-format tal-array jħallik tħallat test u immaġni f’kwalunkwe ordni
- Jeżistu żewġ formati ta’ tismija skont l-endpoint: Kompletamenti taċ-Chat vs Risposti
- Il-parametru
detailjikkontrolla l-fond tal-analiżi tal-immaġni (low, auto, high) - L-immaġni jikkonsmaw tokens: adatta l-livell ta’ dettall għall-ħtiġijiet tiegħek
- Il-format Base64 jħallik tibgħat immaġni mingħajr ma tospitahom online