Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Upload filer med Files API

Lektion 1 af 16 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Fra copy-paste til native dokumenter
  2. Din første upload
  3. Parametre og godkendelse
  4. Brug af filen
  5. Vigtige pointer

Fra copy-paste til native dokumenter

Du har sikkert kopieret femten sider af en rapport ind i et prompt i håb om, at layoutet overlever. Det gør det aldrig: tabelkolonner bliver blandet sammen, og modellen ender med at ræsonnere over en tekstgrød. xAI’s Files API løser præcis dette problem. Du sender det originale dokument, xAI analyserer det på serveren, og Grok arbejder på indhold, hvor struktur, tabeller og sektionsskift bevares.

Mekanismen passer ind i ét enkelt endpoint, POST /v1/files. Du sender din fil som multipart/form-data med en purpose-parameter sat til "assistants", og API’en returnerer en unik identifikator kaldet en file_id. Denne identifikator bliver nøglen til alt, hvad du gør herefter: forespørg dokumentet, tjek dets metadata, slet det, eller tilføj det til en samling.

48 MB
Maks. størrelse pr. fil
POST
HTTP upload-metode
$10
Pr. 1.000 kald
Auto
aktivering af attachment_search

Din første upload

Tag en årsrapport i PDF-format, der ligger på dit drev. Upload-forespørgslen er ikke JSON, men multipart/form-data, hvilket forklarer syntaksen -F i stedet for -d:

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

Svaret kommer inden for få sekunder og indeholder filidentifikatoren sammen med dens egenskaber:

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

Denne file_id – her file_abc123xyz – er din permanente reference til dokumentet. Notér den, så snart du modtager svaret: en mistet identifikator betyder en forældreløs fil, der bruger kvote uden at kunne bruges.

Parametre og godkendelse

Kun to parametre, begge påkrævede:

  • file: Filens binære indhold, sendt som multipart. Maks. størrelse er 48 MB
  • purpose: Altid "assistants", den eneste værdi, der accepteres indtil videre. Det indikerer, at filen vil blive brugt til modelinteraktioner

Du vil ramme grænsen på 48 MB hurtigere, end du måske tror: en log-eksport for én dag eller komplet produktdokumentation overstiger regelmæssigt denne grænse. I så fald skal du opdele din kilde i flere sammenhængende filer i stedet for vilkårligt at beskære dem – du finder dem alle i den samme samling senere.

På godkendelsessiden bærer hver forespørgsel til Files API din standard-API-nøgle i headere Authorization: Bearer. Husk lige nu, at denne nøgle ikke er Management API Key: den er reserveret til samlinger, kommer senere i kurset og forveksles ofte med den første under de første forsøg.

Brug af filen

Den uploadede fil er ubrugelig, medmindre du refererer til den i en forespørgsel. Det er rollen for input_file-blokken i Responses API, som du ledsager af en instruktion i fritekst:

{
  "model": "grok-4.5",
  "input": [
    {
      "type": "input_file",
      "file_id": "file_abc123xyz"
    },
    {
      "type": "input_text",
      "text": "Opsummer dokumentets vigtigste punkter."
    }
  ]
}

Grok modtager filen, aktiverer automatisk værktøjet attachment_search på serveren, udtrækker relevante passager og skriver sit svar baseret på dem. Ingen manuel aktivering er nødvendig, og ingen yderligere parametre skal tilføjes: tilstedeværelsen af en input_file er nok til at udløse hele kæden. Hvert attachments-kald faktureres til $10 pr. 1.000, hvilket gør en enkelt upload, der forespørges ti gange, mere omkostningseffektiv end ti uploads af det samme dokument.

Priser pr. 5. august 2026 — priser ændres regelmæssigt: før enhver budgetberegning skal du tjekke den aktuelle takst på den officielle side for xAI-modeller og priser.

Vigtige pointer

  • Endpointet POST /v1/files accepterer filer på op til 48 MB i multipart/form-data
  • Parameteren purpose skal være "assistants"
  • Den returnerede file_id er din reference til alle efterfølgende operationer
  • Værktøjet attachment_search aktiveres automatisk, når en fil refereres i en forespørgsel
  • Omkostningen er $10 pr. 1.000 attachment-kald