Ladda upp filer med Files API
På denna sida
Från kopiera-klistra till nativa dokument
Du har säkert klistrat in femton sidor av en rapport i en prompt i hopp om att layouten ska bevaras. Det händer aldrig: tabellkolumner blandas ihop och modellen hamnar med att resonera kring en textmassa. xAI:s Files API löser exakt detta problem. Du skickar det ursprungliga dokumentet, xAI analyserar det på serversidan och Grok arbetar med innehåll där struktur, tabeller och avsnittsbrytningar bevaras.
Mekanismen ryms i en enda slutpunkt, POST /v1/files. Du skickar din fil som multipart/form-data med en parameter purpose satt till "assistants", och API:et returnerar en unik identifierare som kallas file_id. Denna identifierare blir nyckeln till allt du gör härnäst: fråga dokumentet, kontrollera dess metadata, radera det eller lägga till det i en samling.
Din första uppladdning
Ta en årsredovisning i PDF-format som ligger på din hårddisk. Uppladdningsbegäran är inte JSON utan multipart/form-data, vilket förklarar syntaxen -F istället för -d:
curl -X POST https://api.x.ai/v1/files \
-H "Authorization: Bearer $XAI_API_KEY" \
-F "[email protected]" \
-F "purpose=assistants"
Svaret kommer inom några sekunder och innehåller filidentifieraren tillsammans med dess egenskaper:
{
"id": "file_abc123xyz",
"object": "file",
"bytes": 2458901,
"created_at": 1710000000,
"filename": "annual-report.pdf",
"purpose": "assistants"
}
Denna file_id – här file_abc123xyz – är din permanenta referens till dokumentet. Anteckna den så fort du får svaret: en förlorad identifierare betyder en föräldralös fil som konsumerar kvot utan att gå att använda.
Parametrar och autentisering
Endast två parametrar, båda obligatoriska:
- file: Filens binära innehåll, skickat som multipart. Maxstorlek är 48 MB
- purpose: Alltid
"assistants", det enda värde som accepteras hittills. Det indikerar att filen kommer att användas för modellinteraktioner
Du kommer att nå gränsen på 48 MB snabbare än du tror: en loggexport för en enda dag eller komplett produktdokumentation överskrider den regelbundet. Dela i så fall upp din källa i flera sammanhängande filer istället för att godtyckligt klippa bort delar – du hittar dem ändå i samma samling senare.
När det gäller autentisering bär varje begäran till Files API din vanliga API-nyckel i headern Authorization: Bearer. Kom ihåg redan nu att denna nyckel inte är samma sak som Management API Key: den senare, som är reserverad för samlingar, kommer längre fram i kursen och förväxlas ofta med den första vid de första försöken.
Använda filen
Den uppladdade filen är värdelös om du inte refererar till den i en begäran. Det är rollen för blocket input_file i Responses API, som du kompletterar med en instruktion i fritt textformat:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_id": "file_abc123xyz"
},
{
"type": "input_text",
"text": "Sammanfatta dokumentets viktigaste punkter."
}
]
}
Grok tar emot filen, aktiverar automatiskt verktyget attachment_search på serversidan, extraherar relevanta passager och skriver sitt svar baserat på dem. Ingen manuell aktivering behövs och inga ytterligare parametrar behöver läggas till: förekomsten av en input_file räcker för att trigga hela kedjan. Varje bilageanrop debiteras med $10 per 1 000, vilket gör att en enda uppladdning som frågas tio gånger är mer kostnadseffektiv än tio uppladdningar av samma dokument.
Priser från och med den 5 augusti 2026 – priserna ändras regelbundet: innan du gör någon budgetberäkning, kontrollera den aktuella prislistan på den officiella sidan för xAI-modeller och prissättning.
Viktiga punkter
- Slutpunkten
POST /v1/filesaccepterar filer på upp till 48 MB i formatetmultipart/form-data - Parametern
purposemåste vara"assistants" - Den returnerade
file_idär din referens för alla efterföljande operationer - Verktyget
attachment_searchaktiveras automatiskt när en fil refereras i en begäran - Kostnaden är $10 per 1 000 bilageanrop