Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Uaslódáil Comhad leis an API Comhad

Ceacht 1 as 16 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Ó chóipeáil-greamú go dtí doiciméid dhúchasacha
  2. Do chéad uaslódáil
  3. Paraiméadair agus fíordheimhniú
  4. An comhad a úsáid
  5. Príomhphointí

Ó 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.

48 MB
Uasmhéid in aghaidh an chomhaid
POST
Modh uaslódála HTTP
$10
In aghaidh gach 1,000 glao
Uathoibríoch
Gníomhachtú attachment_search

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/files le comhaid suas le 48 MB i multipart/form-data
  • Caithfidh an paraiméadar purpose a bheith "assistants"
  • Is é an file_id a fhilltear do thagairt do gach oibríocht ina dhiaidh sin
  • Gníomhachtaíonn an uirlis attachment_search go huathoibríoch nuair a dhéantar tagairt do chomhad in iarratas
  • Is é $10 in aghaidh gach 1,000 glao ceangaltáin an costas