Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Augšupielādēt failus, izmantojot Files API

Nodarbība 1 no 16 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. No kopēšanas-ielīmēšanas uz natīviem dokumentiem
  2. Tava pirmā augšupielāde
  3. Parametri un autentifikācija
  4. Faila izmantošana
  5. Galvenās atziņas

No kopēšanas-ielīmēšanas uz natīviem dokumentiem

Tu droši vien esi ielīmējis piecpadsmit lappušu garu ziņojumu uzvednē, cerot, ka izkārtojums saglabāsies. Tas nekad nenotiek: tabulu kolonnas sajaucas, un modelis beidz spriest par teksta putru. xAI Files API atrisina tieši šo problēmu. Tu nosūti sākotnējo dokumentu, xAI to analizē servera pusē, un Grok strādā ar saturu, kurā ir saglabāta struktūra, tabulas un sadaļu atdalījumi.

Mehānisms ietilpst vienā galapunktā: POST /v1/files. Tu nosūti savu failu kā multipart/form-data ar parametru purpose, kas iestatīts uz "assistants", un API atgriež unikālu identifikatoru ar nosaukumu file_id. Šis identifikators kļūst par atslēgu visam, ko darīsi tālāk: dokumenta vaicāšanai, tā metadatu pārbaudei, dzēšanai vai pievienošanai kolekcijai.

48 MB
Maksimālais faila izmērs
POST
HTTP augšupielādes metode
$10
Par 1000 izsaukumiem
Auto
attachment_search aktivizēšana

Tava pirmā augšupielāde

Paņem gada pārskatu PDF formātā, kas glabājas tavā diskā. Augšupielādes pieprasījums nav JSON, bet gan multipart/form-data, kas izskaidro -F sintaksi -d vietā:

curl -X POST https://api.x.ai/v1/files \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -F "[email protected]" \
  -F "purpose=assistants"

Atbilde pienāk dažu sekunžu laikā un satur faila identifikatoru kopā ar tā raksturlielumiem:

{
  "id": "file_abc123xyz",
  "object": "file",
  "bytes": 2458901,
  "created_at": 1710000000,
  "filename": "annual-report.pdf",
  "purpose": "assistants"
}

Šis file_id — šajā gadījumā file_abc123xyz — ir tava pastāvīgā atsauce uz dokumentu. Atzīmē to uzreiz, kad saņem atbildi: pazudis identifikators nozīmē pamestu failu, kas patērē kvotu, bet nav lietojams.

Parametri un autentifikācija

Tikai divi parametri, abi obligāti:

  • file: Faila binārais saturs, nosūtīts kā multipart. Maksimālais izmērs ir 48 MB.
  • purpose: Vienmēr "assistants", kas līdz šim ir vienīgā pieņemtā vērtība. Tas norāda, ka fails tiks izmantots mijiedarbībai ar modeli.

Tu sasniegsi 48 MB robežu ātrāk, nekā vari domāt: vienas dienas žurnāla eksports vai pilna produkta dokumentācija to regulāri pārsniedz. Šādā gadījumā sadali avotu vairākos loģiskos failos, nevis patvaļīgi to saīsini — vēlāk tos visus atradīsi vienā kolekcijā.

Autentifikācijas ziņā katrs Files API pieprasījums satur tavu standarta API atslēgu galvenē Authorization: Bearer. Patur prātā jau tagad, ka šī atslēga nav Management API Key: tā, kas paredzēta kolekcijām, tiks apskatīta kursa turpinājumā, un sākumā tās bieži tiek sajauktas.

Faila izmantošana

Augšupielādētais fails ir bezjēdzīgs, ja tu to neatsauci pieprasījumā. Tieši šo lomu Responses API spēlē input_file bloks, ko papildini ar brīvas formas teksta instrukciju:

{
  "model": "grok-4.5",
  "input": [
    {
      "type": "input_file",
      "file_id": "file_abc123xyz"
    },
    {
      "type": "input_text",
      "text": "Summarize the key points of this document."
    }
  ]
}

Grok saņem failu, automātiski aktivizē rīku attachment_search servera pusē, izgūst attiecīgās pasāžas un, balstoties uz tām, ģenerē atbildi. Nav nepieciešama manuāla aktivizēšana vai papildu parametru pievienošana: input_file klātbūtne ir pietiekama, lai iedarbinātu visu ķēdi. Katrs pielikuma izsaukums tiek tarifēts ar $10 par 1000 reizēm, padarot vienu augšupielādi, ko vaicā desmit reizes, izdevīgāku nekā viena un tā paša dokumenta desmit atsevišķas augšupielādes.

Cenas uz 2026. gada 5. augustu — cenas mainās regulāri: pirms jebkādiem budžeta aprēķiniem pārbaudi aktuālo cenrādi oficiālajā xAI modeļu un cenu lapā.

Galvenās atziņas

  • Galapunkts POST /v1/files pieņem failus līdz 48 MB formātā multipart/form-data
  • Parametram purpose jābūt iestatītam uz "assistants"
  • Atgrieztais file_id ir tava atsauce visām turpmākajām operācijām
  • Rīks attachment_search aktivizējas automātiski, kad pieprasījumā tiek atsaukts fails
  • Izmaksas ir $10 par 1000 pielikuma izsaukumiem