Uaslódáil Comhad leis an API Comhad
Ar an leathanach seo
Ó chóipeáil-greamú go dtí doiciméid dhúchasacha
Is dócha go ndearna tú greamú de chúig leathanach déag tuarascála isteach i leid, ag súil go mairfeadh an leagan amach. Ní mhaireann sé riamh: meascann colúin táblaí le chéile agus críochnaíonn an tsamhail ag déanamh réasúnaíochta ar shilín téacs. Réitíonn API Comhad xAI an fhadhb seo go díreach. Seolann tú an bun-doiciméad, déanann xAI anailís air ar an taobh freastalaí, agus oibríonn Grok ar ábhar ina bhfuil an struchtúr, na táblaí, agus na briseadh alt caomhnaithe.
Oireann an mheicníocht d’aon chríochphoint amháin, POST /v1/files. Seolann tú do chomhad mar multipart/form-data le paraiméadar purpose socraithe ar "assistants", agus filleann an API aitheantóir uathúil ar a dtugtar file_id. Is é an t-aitheantóir seo an eochair do gach rud a dhéanann tú ina dhiaidh sin: an doiciméad a fhiosrú, a mheiteashonraí a sheiceáil, é a scriosadh, nó é a chur le bailiúchán.
Do chéad uaslódáil
Tóg tuarascáil bhliantúil i bhformáid PDF atá ar do thiomántán. Ní JSON atá san iarratas uaslódála ach multipart/form-data, rud a mhíníonn an chomhréir -F in ionad -d:
curl -X POST https://api.x.ai/v1/files \
-H "Authorization: Bearer $XAI_API_KEY" \
-F "[email protected]" \
-F "purpose=assistants"
Tagann an freagra laistigh de chúpla soicind agus tá an t-aitheantóir comhaid ann mar aon lena shaintréithe:
{
"id": "file_abc123xyz",
"object": "file",
"bytes": 2458901,
"created_at": 1710000000,
"filename": "annual-report.pdf",
"purpose": "assistants"
}
Is é an file_id seo—file_abc123xyz sa chás seo—do thagairt bhuan don doiciméad. Tabhair faoi deara é chomh luath agus a fhaigheann tú an freagra: ciallaíonn aitheantóir caillte comhad dílleachta a ídíonn cuóta gan bheith inúsáidte.
Paraiméadair agus fíordheimhniú
Níl ach dhá pharaiméadar ann, agus tá siad beirt éigeantach:
- file: Ábhar dénártha an chomhaid, seolta mar mhultipart. Is é 48 MB an t-uasmhéid
- purpose: I gcónaí
"assistants", an t-aon luach a nglactar leis go dtí seo. Léiríonn sé go n-úsáidfear an comhad le haghaidh idirghníomhaíochtaí samhaltaithe
Buaileann tú an teorainn 48 MB níos tapúla ná mar a shamhlófá: sáraíonn onnmhairiú loga lá amháin nó doiciméadú iomlán táirge go minic é. Sa chás seo, roinn do fhoinse ina roinnt comhad comhleanúnacha seachas iad a ghearradh go treallach—gheobhaidh tú iad go léir sa bhailiúchán céanna ina dhiaidh sin.
Ar thaobh an fhíordheimhnithe, iompraíonn gach iarratas chuig an API Comhad do eochair API chaighdeánach sa cheanntásc Authorization: Bearer. Coinnigh i gcuimhne anois nach é an Eochair API Bainistíochta atá san eochair seo: tá an ceann sin, atá curtha in áirithe do bhailiúcháin, le teacht níos déanaí sa chúrsa agus is minic a dhéantar mearbhall air leis an gcéad cheann le linn iarrachtaí luatha.
An comhad a úsáid
Níl aon mhaith sa chomhad uaslódaithe mura ndéanann tú tagairt dó in iarratas. Is é seo ról an bhloic input_file san API Freagraí, a chuireann tú le treoir téacs saor in aisce:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_id": "file_abc123xyz"
},
{
"type": "input_text",
"text": "Déan achoimre ar phríomhphointí an doiciméid seo."
}
]
}
Faigheann Grok an comhad, gníomhachtaíonn sé an uirlis attachment_search go huathoibríoch ar an taobh freastalaí, baineann sé pasáin ábhartha amach, agus scríobhann sé a fhreagra bunaithe orthu. Níl aon ghníomhachtú láimhe ag teastáil, agus ní gá aon pharaiméadair bhreise a chur leis: tá láithreacht input_file leordhóthanach chun an slabhra iomlán a spreagadh. Billeáiltear gach glao ceangaltáin ag $10 in aghaidh gach 1,000, rud a fhágann go bhfuil uaslódáil amháin a fhiosraítear deich n-uaire níos cost-éifeachtaí ná deich n-uaslódáil den doiciméad céanna.
Praghsáil ón 5 Lúnasa 2026 — athraíonn praghsanna go rialta: sula ndéanann tú aon ríomh buiséid, seiceáil an greille reatha ar leathanach oifigiúil samhlacha agus praghsanna xAI.
Príomhphointí
- Glacann an críochphoint
POST /v1/filesle comhaid suas le 48 MB imultipart/form-data - Caithfidh an paraiméadar
purposea bheith"assistants" - Is é an
file_ida fhilltear do thagairt do gach oibríocht ina dhiaidh sin - Gníomhachtaíonn an uirlis
attachment_searchgo huathoibríoch nuair a dhéantar tagairt do chomhad in iarratas - Is é $10 in aghaidh gach 1,000 glao ceangaltáin an costas