Formati tal-Immaġni: URL u Base64
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026. Bl-API tar-Risposti, l-oġġetti
input_imageuinput_textimorru fil-contentta’ messaġġ{"role": "user", ...}, mhux direttament f’input. L-eżempju Python qabel kien isejaħclient.responses.create()fuq il-klijentxai-sdk, li ma għandux dan il-metodu, u kien jikteb iċ-ċavetta tal-API fil-kodiċi: issa jużauser(...)uimage(...)mill-SDK, biċ-ċavetta moqrija mill-ambjent. Żdied twissija ta’ xAI dwar il-ħażna tal-istorja. Il-kodiċi ġie vverifikat ma’xai-sdk1.21.0. Sors: Fehim tal-Immaġni.
Tibgħat Immaġni lil Grok
Il-mudelli Grok minn grok-4.5 ‘il quddiem jinkludu kapaċitajiet tal-viżjoni. Tista’ tibgħat immaġni waħda jew aktar fit-talbiet tal-API tiegħek, u l-mudell janalizzahom biex iwieġeb il-mistoqsijiet tiegħek. Dan jissejjaħ fehim tal-immaġni, jew viżjoni multimodali.
Qabel ma tidħol fil-każijiet ta’ użu, huwa essenzjali li tħakkar iż-żewġ formati ta’ sottomissjoni tal-immaġni appoġġjati mill-API ta’ xAI.
URL Dirett
L-aktar metodu sempliċi huwa li tipprovdi l-URL pubblika ta’ immaġni. Il-mudell se jniżżilha u janalizzaha awtomatikament.
Bl-API tar-Risposti (endpoint prinċipali):
{
"model": "grok-4.5",
"input": [
{
"role": "user",
"content": [
{
"type": "input_image",
"image_url": "https://exemple.com/photo-produit.jpg"
},
{
"type": "input_text",
"text": "Iddeskrivi din l-immaġni fid-dettall."
}
]
}
]
}
xAI jirrakkomanda li meta tibgħat immaġni, ma taħżinx l-istorja tat-talba u r-risposta fuq is-servers tagħhom, inkella t-talba tista’ tfalli: bl-API tar-Risposti, għaddi "store": false.
Bl-API tal-Kompletamenti taċ-Chat (antik, kompatibbli ma’ OpenAI):
{
"model": "grok-4.5",
"messages": [
{
"role": "user",
"content": [
{
"type": "image_url",
"image_url": {
"url": "https://exemple.com/photo-produit.jpg"
}
},
{
"type": "text",
"text": "Iddeskrivi din l-immaġni fid-dettall."
}
]
}
]
}
L-URL irid jipponta lejn fajl ta’ immaġni aċċessibbli pubblikament. Jekk l-immaġni tkun wara awtentikazzjoni jew CDN protett, uża l-format Base64 minflok.
Ikkodifikat Base64 (Data URI)
It-tieni format jinvolvi li tikkodifika l-immaġni direttament fit-talba bħala stringa Base64 preċeduta minn prefiss MIME. Dan huwa l-metodu ideali meta taħdem ma’ immaġni lokali, screenshots, jew fajls iġġenerati dinamikament.
{
"type": "input_image",
"image_url": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."
}
Il-prefiss data:image/jpeg;base64, jgħid lill-mudell it-tip MIME tal-immaġni. Aġġustah skont il-format:
data:image/jpeg;base64,għal fajls JPG/JPEGdata:image/png;base64,għal fajls PNG
Kif Tikkodifika Immaġni f’Python
import base64
with open("photo.jpg", "rb") as f:
image_data = base64.standard_b64encode(f.read()).decode("utf-8")
image_url = f"data:image/jpeg;base64,{image_data}"
Kif Tikkodifika f’JavaScript/Node.js
import { readFileSync } from 'fs';
const imageData = readFileSync('photo.jpg').toString('base64');
const imageUrl = `data:image/jpeg;base64,${imageData}`;
Differenzi Ewlenin bejn URL u Base64
| Kriterju | URL | Base64 |
|---|---|---|
| Daqs tat-talba | Ħafif (biss l-URL) | Tqil (+33% meta mqabbel mal-fajl oriġinali) |
| Aċċessibbiltà | Teħtieġ immaġni pubblika | Jaħdem ma' kwalunkwe fajl lokali |
| Latency | Tniżżil mis-server | Dejta direttament fit-talba |
| Każ ta' użu tipiku | Immaġni tal-web, CDN, ħażna cloud | Fajls lokali, screenshots, uploads |
Taħlit ta’ Test u Immaġni
Il-content ta’ messaġġ jaċċetta array imħallat ta’ oġġetti input_image u input_text, f’kwalunkwe ordni: tista’ tibdel liberament bejn test u immaġni. Bl-SDK nativ ta’ xAI, l-istess messaġġ jinbena b’user(), li jaċċetta test u immaġni maħluqa minn image() f’sekwenza:
from xai_sdk import Client
from xai_sdk.chat import image, user
client = Client() # iċ-ċavetta moqrija minn XAI_API_KEY
chat = client.chat.create(model="grok-4.5")
chat.append(
user(
"Qabbel dawn iż-żewġ ritratti:",
image(image_url="https://exemple.com/photo1.jpg", detail="high"),
image(image_url="https://exemple.com/photo2.jpg", detail="high"),
"X'inhu d-differenzi ewlenin?",
)
)
response = chat.sample()
print(response.content)
image() taċċetta URL pubblika jew Data URI Base64.
Punti Ewlenin
- Żewġ formati ta’ immaġni huma appoġġjati: URL Dirett u Base64 (Data URI)
- Il-formati aċċettati huma biss JPG, JPEG, u PNG
- Kull immaġni m’għandhiex taqbeż 20 MiB
- In-numru ta’ immaġni għal kull talba huwa mhux limitat
- L-API tar-Risposti tpoġġi
input_imagefil-contentta’ messaġġ; il-Kompletamenti taċ-Chat jużaw partijietimage_url; l-SDK ta’ xAI jużaimage()ġewwauser() - Ippreferi l-URL għal immaġni pubbliċi u Base64 għal fajls lokali