Claude Files API: upload og analyser dokumenter automatisk

Files API er Anthropics løsning på et klassisk problem: hvad gør du, når du skal analysere det samme dokument i mange API-kald? Normalt ville du sende dokumentet som base64-encoded data ved hvert kald — en ineffektiv og dyr tilgang. Files API lader dig i stedet uploade filen én gang og referere til den med et file_id i alle efterfølgende kald.

Hvad er Files API?

Files API er en persistens-tjeneste på Anthropics servere. Du uploader en fil én gang, og Anthropic gemmer den sikkert. Derefter kan du bruge file_id i dine API-kald, og Claude henter filen direkte fra lageret — ingen gentagelse, ingen unødvendig databelastning.

Det er ikke blot en optimering; det åbner for nye arkitekturmønstre, fx RAG-pipelines og multi-step dokumentanalyse, der ville være upraktiske med base64-encoding.

Understøttede filtyper

• PDF: Rapporter, kontrakter, fakturaer
• Tekst: .txt, .md, .csv, kildekode
• Billeder: .jpg, .png, .webp, .gif
• Microsoft Office: .docx, .xlsx (med understøttelse via konvertering)

Upload én gang — brug mange gange

Det store salgspunkt er genbrugelighed. I stedet for at sende den samme 100-siders rapport som base64 i hvert kald — hvilket er både langsomt og dyrt — uploader du rapporten én gang og refererer til file_id:

import anthropic

client = anthropic.Anthropic()

# Upload filen én gang
with open("aarsrapport-2025.pdf", "rb") as f:
    file_obj = client.beta.files.upload(
        file=("aarsrapport-2025.pdf", f, "application/pdf"),
    )

file_id = file_obj.id
print(f"Fil uploadet: {file_id}")

# Brug file_id i mange kald
spørgsmål = [
    "Hvad er den samlede omsætning for 2025?",
    "Hvad er de tre vigtigste risikofaktorer?",
    "Sammenfat ledelsesberetningen i tre punkter.",
]

for spørgsmål_tekst in spørgsmål:
    response = client.beta.messages.create(
        model="claude-opus-4-5",
        max_tokens=1024,
        messages=[
            {
                "role": "user",
                "content": [
                    {
                        "type": "document",
                        "source": {
                            "type": "file",
                            "file_id": file_id,
                        },
                    },
                    {
                        "type": "text",
                        "text": spørgsmål_tekst,
                    }
                ],
            }
        ],
        betas=["files-api-2025-04-14"],
    )
    print(f"Q: {spørgsmål_tekst}")
    print(f"A: {response.content[0].text}
")

Levetid og sletning

Filer på Anthropics servere slettes automatisk efter 30 dage. Du kan også slette dem manuelt via API’et, hvilket er god praksis for filer med fortroligt indhold. Filer er knyttet til din API-nøgle og er ikke tilgængelige for andre.

Hvornår skal du bruge Files API?

• Dokumentanalyse på tværs af mange kald: Analysér én rapport med 20 forskellige spørgsmål.
• RAG-pipelines: Upload dit videngrundlag og referér til det i søgebaserede svar.
• Batch-behandling: Send den samme fil til mange parallelle API-kald uden at gentage upload.

Forskellen fra base64-encoding

Med base64-encoding konverteres filen til tekst og sendes som del af din prompt ved hvert kald. Det øger token-forbruget dramatisk — en 10 MB PDF kan svare til hundredtusinder af tokens. Files API omgår dette fuldstændigt: du sender kun et file_id, og tjenesten henter filen internt. Resultatet er lavere latens, lavere token-forbrug og renere kode.

Investeringen i Files API betaler sig hurtigt, når du arbejder med dokumenter der genbruges på tværs af kald.