Ittella' Fajls bl-API tal-Fajls
F'din il-paġna
Mill-copy-paste għal dokumenti nattivi
X’aktarx li diġà ppastejt ħmistax-il paġna ta’ rapport f’prompt bit-tama li l-format jibqa’ intatt. Qatt ma jiġri hekk: il-kolonni tat-tabelli jitħalltu u l-mudell jispiċċa jirraġuna fuq ġibla ta’ test. L-API tal-Fajls ta’ xAI issolvi eżattament din il-problema. Tibgħat id-dokument oriġinali, xAI janalizzah fuq is-server, u Grok jaħdem fuq kontenut fejn l-istruttura, it-tabelli u l-bidliet tas-sezzjonijiet jinżammu.
Il-mekkaniżmu jidħol f’endpoint wieħed biss, POST /v1/files. Tibgħat il-fajl tiegħek bħala multipart/form-data b’parametru purpose impost fuq "assistants", u l-API tirritorna identifikatur uniku msejjaħ file_id. Dan l-identifikatur isir iċ-ċavetta għal kull ma tagħmel wara: tistaqsidokument, tiċċekkja l-metadejta tiegħu, tħassru, jew iżżidu ma’ kollezzjoni.
L-ewwel upload tiegħek
Ħu rapport annwali fil-format PDF li għandek fuq id-disk tiegħek. It-talba tal-upload mhix JSON iżda multipart/form-data, li jispjega s-sintassi -F minflok -d:
curl -X POST https://api.x.ai/v1/files \
-H "Authorization: Bearer $XAI_API_KEY" \
-F "[email protected]" \
-F "purpose=assistants"
Ir-risposta tasal f’ftit sekondi u fiha l-identifikatur tal-fajl flimkien mal-karatteristiċi tiegħu:
{
"id": "file_abc123xyz",
"object": "file",
"bytes": 2458901,
"created_at": 1710000000,
"filename": "annual-report.pdf",
"purpose": "assistants"
}
Dan il-file_id—hawnhekk file_abc123xyz—huwa r-referenza permanenti tiegħek għad-dokument. Innotah hekk kif tirċievi r-risposta: identifikatur mitluf ifisser fajl orfni li jikkonsma kwota mingħajr ma jkun użabbli.
Parametri u awtentikazzjoni
Hemm żewġ parametri biss, it-tnejn meħtieġa:
- file: Il-kontenut binarju tal-fajl, mibgħut bħala multipart. Id-daqs massimu huwa 48 MB
- purpose: Dejjem
"assistants", l-uniku valur aċċettat sad-data. Jindika li l-fajl se jintuża għal interazzjonijiet mal-mudell
Se tilħaq il-limitu ta’ 48 MB aktar malajr milli taħseb: esportazzjoni ta’ logs ta’ jum wieħed jew dokumentazzjoni sħiħa tal-prodott spiss taqbeż dan il-limitu. F’dan il-każ, aqsam is-sors tiegħek f’diversi fajls koerenti minflok ma taqta’ b’mod arbitrarju—issibhom kollha fl-istess kollezzjoni aktar tard.
Fuq in-naħa tal-awtentikazzjoni, kull talba lill-API tal-Fajls iġġorri l-API key standard tiegħek fl-header Authorization: Bearer. Żomm f’moħħok issa li din iċ-ċavetta mhix il-Management API Key: dik, riżervata għall-kollezzjonijiet, tiġi aktar tard fil-kors u spiss tiġi konfuża mal-ewwel waħda matul l-ewwel tentattivi.
L-użu tal-fajl
Il-fajl imtella’ ma jservi xejn jekk ma tirreferenzjax f’talba. Dan huwa r-rwol tal-blokka input_file fl-API tar-Risposti, li takkumpanjah b’istruzzjoni f’test liberu:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_id": "file_abc123xyz"
},
{
"type": "input_text",
"text": "Agħmel sommarju tal-punti ewlenin ta' dan id-dokument."
}
]
}
Grok jirċievi l-fajl, jattiva awtomatikament l-għodda attachment_search fuq is-server, jestratti passiġġi rilevanti, u jikteb ir-risposta tiegħu abbażi tagħhom. M’hemmx bżonn ta’ attivazzjoni manwali, u l-ebda parametru addizzjonali m’għandu jiġi miżjud: il-preżenza ta’ input_file biżżejjed biex tħaddem iċ-ċ catena kollha. Kull sejħa ta’ attachement tiġi fatturata b’$10 għal kull 1,000, li jagħmel upload wieħed mistoqsi għaxar darbiet aktar effiċjenti fl-ispejjeż minn għaxar uploads tal-istess dokument.
Prezzijiet sal-5 ta’ Awwissu 2026 — il-prezzijiet jinbidlu regolarment: qabel kwalunkwe kalkolu tal-baġit, iċċekkja l-grilja attwali fuq il-paġna uffiċjali tal-mudelli u l-prezzijiet ta’ xAI.
Punti Ewlenin
- L-endpoint
POST /v1/filesjaċċetta fajls sa 48 MB f’multipart/form-data - Il-parametru
purposeirid ikun"assistants" - Il-
file_idirritornat huwa r-referenza tiegħek għall-operazzjonijiet sussegwenti kollha - L-għodda
attachment_searchtiġi attivata awtomatikament meta fajl jiġi rreferenzjat f’talba - L-ispiża hija ta’ $10 għal kull 1,000 sejħa ta’ attachement