Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Ittella' Fajls bl-API tal-Fajls

Lezzjoni 1 / 16 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Mill-copy-paste għal dokumenti nattivi
  2. L-ewwel upload tiegħek
  3. Parametri u awtentikazzjoni
  4. L-użu tal-fajl
  5. Punti Ewlenin

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.

48 MB
Daqs massimu għal kull fajl
POST
Metodu ta' upload HTTP
$10
Għal kull 1,000 sejħa
Auto
attivazzjoni ta' attachment_search

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/files jaċċetta fajls sa 48 MB f’multipart/form-data
  • Il-parametru purpose irid ikun "assistants"
  • Il-file_id irritornat huwa r-referenza tiegħek għall-operazzjonijiet sussegwenti kollha
  • L-għodda attachment_search tiġ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