Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Ladda upp filer med Files API

Lektion 1 av 16 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Från kopiera-klistra till nativa dokument
  2. Din första uppladdning
  3. Parametrar och autentisering
  4. Använda filen
  5. Viktiga punkter

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.

48 MB
Max storlek per fil
POST
HTTP-uppladdningsmetod
$10
Per 1 000 anrop
Auto
aktivering av attachment_search

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/files accepterar filer på upp till 48 MB i formatet multipart/form-data
  • Parametern purpose måste vara "assistants"
  • Den returnerade file_id är din referens för alla efterföljande operationer
  • Verktyget attachment_search aktiveras automatiskt när en fil refereras i en begäran
  • Kostnaden är $10 per 1 000 bilageanrop