Augšupielādēt failus, izmantojot Files API
Šajā lapā
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.
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/filespieņem failus līdz 48 MB formātāmultipart/form-data - Parametram
purposejābūt iestatītam uz"assistants" - Atgrieztais
file_idir tava atsauce visām turpmākajām operācijām - Rīks
attachment_searchaktivizējas automātiski, kad pieprasījumā tiek atsaukts fails - Izmaksas ir $10 par 1000 pielikuma izsaukumiem