Claude Platform Docs
MessaggiLavorare con i file

Supporto PDF

Elabora PDF con Claude: estrai testo, analizza grafici e comprendi i contenuti visivi dei tuoi documenti.

Puoi chiedere a Claude informazioni su qualsiasi testo, immagine, grafico e tabella presente nei PDF che fornisci. Alcuni casi d’uso di esempio:

  • Analizzare report finanziari e comprendere grafici/tabelle
  • Estrarre informazioni chiave da documenti legali
  • Aiutare nella traduzione di documenti
  • Convertire le informazioni dei documenti in formati strutturati

Prima di iniziare

Verifica i requisiti dei PDF

Claude funziona con qualsiasi PDF standard. Assicurati che la dimensione della tua richiesta rispetti questi requisiti:

RequisitoLimite
Dimensione massima della richiesta128 MB sulla Claude API di prima parte (varia in base alla piattaforma; vedi limiti di dimensione delle richieste)
Numero massimo di pagine per richiesta600 (100 quando la finestra di contesto della richiesta è inferiore a 1M di token)
FormatoPDF standard (senza password/crittografia)

Entrambi i limiti si applicano all’intero payload della richiesta, incluso qualsiasi altro contenuto inviato insieme ai PDF. Per PDF di grandi dimensioni, valuta di caricarli con la Files API e di referenziarli tramite file_id per mantenere ridotti i payload delle richieste.

Poiché il supporto PDF si basa sulle capacità di visione di Claude, è soggetto alle stesse limitazioni e considerazioni degli altri compiti di visione.

Piattaforme e modelli supportati

Tutti i modelli attivi supportano l’elaborazione dei PDF.

Elabora PDF con Claude

Invia la tua prima richiesta PDF

Inizia con un esempio che usa la Messages API. Per fornire un PDF a Claude, invialo in un blocco di contenuto documentAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro) con uno dei tre tipi di sorgente. La tua piattaforma determina quali tipi puoi usare (vedi Disponibilità). Tra questi tipi, scegli in base a dove si trova il PDF, alle sue dimensioni e alla frequenza con cui lo usi:

  1. Un PDF ospitato online: referenzialo tramite il suo URL (Opzione 1: Documento PDF basato su URL).
  2. Un PDF sul tuo sistema locale o senza un URL: invialo come dati codificati in base64 (Opzione 2: Documento PDF codificato in base64).
  3. Un PDF di grandi dimensioni o che userai ripetutamente: caricalo con la Files API e referenzialo tramite il suo file_id (Opzione 3: Files API).

Opzione 1: Documento PDF basato su URL

Referenzia il PDF tramite il suo URL:

client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "url",
                        "url": "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf",
                    },
                },
                {"type": "text", "text": "What are the key findings in this document?"},
            ],
        }
    ],
)

print(message.content)

La risposta restituisce l’analisi di Claude come blocchi di testo in content, con il consumo di token in usage:

Output
{
  "id": "msg_01Hfp8YuFjQ55VgWbpdHDehB",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5-5",
  "content": [
    {
      "type": "text",
      "text": "This document is an addendum to the Claude 3 model card, reporting updated evaluation results. The key findings include..."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 45000,
    "output_tokens": 300
  }
}

Opzione 2: Documento PDF codificato in base64

Invia il PDF come dati codificati in base64 nella richiesta stessa. La maggior parte degli esempi seguenti scarica un PDF di esempio e lo codifica, quindi non richiede alcun file locale. Per inviare un file locale in quegli esempi, sostituisci le righe che scaricano e codificano il PDF con le righe commentate:

import base64
import httpx2

# Per prima cosa, carica e codifica il PDF
pdf_url = "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf"
pdf_data = base64.standard_b64encode(
    httpx2.get(pdf_url, follow_redirects=True).content
).decode("utf-8")

# Alternativa: carica da un file locale
# with open("document.pdf", "rb") as f:
#     pdf_data = base64.standard_b64encode(f.read()).decode("utf-8")

# Invia a Claude usando la codifica base64
client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "base64",
                        "media_type": "application/pdf",
                        "data": pdf_data,
                    },
                },
                {"type": "text", "text": "What are the key findings in this document?"},
            ],
        }
    ],
)

print(message.content)

Opzione 3: Files API

Per i PDF che userai ripetutamente, o quando vuoi evitare l’overhead della codifica, usa la Files API:

client = anthropic.Anthropic()

# Carica il file PDF
with open("/path/to/document.pdf", "rb") as f:
    file_upload = client.files.upload(file=("document.pdf", f, "application/pdf"))

# Usa il file caricato in un messaggio
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {"type": "file", "file_id": file_upload.id},
                },
                {"type": "text", "text": "What are the key findings in this document?"},
            ],
        }
    ],
)

print(message.content)

Come funziona il supporto PDF

Quando invii un PDF a Claude, si verificano i seguenti passaggi:

  1. Il sistema estrae i contenuti del documento.

    • Il sistema converte ogni pagina del documento in un’immagine.
    • Il sistema estrae il testo di ogni pagina e lo fornisce insieme all’immagine di quella pagina.
  2. Claude analizza sia il testo sia le immagini.

    • Claude riceve ogni documento come combinazione di testo e immagini.
    • Poiché Claude riceve un’immagine di ogni pagina, puoi chiedere approfondimenti sugli elementi visivi di un PDF, come grafici, diagrammi e altri contenuti non testuali.
  3. Claude usa i contenuti del PDF nella sua risposta, se pertinente.

    Claude può attingere sia ai contenuti testuali sia a quelli visivi nella sua risposta.

Stima i tuoi costi

Il conteggio dei token di un file PDF dipende dal testo totale estratto dal documento e dal numero di pagine:

  • Costi dei token di testo: ogni pagina utilizza tipicamente 1.500–3.000 token a seconda della densità del contenuto. Si applicano i prezzi standard dell’API senza costi aggiuntivi per i PDF.
  • Costi dei token di immagine: l’immagine di ogni pagina utilizza al massimo 1.568 token visivi su ogni modello, perché l’API adatta le immagini delle pagine ai limiti del livello di risoluzione standard. Per sapere come contare i token visivi di un’immagine, consulta Risoluzione e costo in token.

Puoi usare il conteggio dei token per stimare i costi dei tuoi PDF specifici.

Ottimizza l’elaborazione dei PDF

Puoi combinare il supporto PDF con altre funzionalità:

Migliora le prestazioni

Segui queste best practice per risultati ottimali:

  • Posiziona i PDF prima del testo nelle tue richieste
  • Usa font standard
  • Assicurati che il testo sia chiaro e leggibile
  • Ruota le pagine nell’orientamento verticale corretto
  • Usa i numeri di pagina logici (dal visualizzatore PDF) nei prompt
  • Suddividi i PDF di grandi dimensioni in parti quando necessario
  • Abilita la cache dei prompt per le analisi ripetute

Scala la tua implementazione

Per l’elaborazione ad alto volume, valuta questi approcci:

Usa la cache dei prompt

Memorizza nella cache i PDF con il “prompt caching” (cache dei prompt) per migliorare le prestazioni nelle query ripetute:

import base64
import httpx2

# Per prima cosa, carica e codifica il PDF
pdf_url = "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf"
pdf_data = base64.standard_b64encode(
    httpx2.get(pdf_url, follow_redirects=True).content
).decode("utf-8")

# Crea un messaggio con il documento in cache
client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "base64",
                        "media_type": "application/pdf",
                        "data": pdf_data,
                    },
                    "cache_control": {"type": "ephemeral"},
                },
                {
                    "type": "text",
                    "text": "Which model has the highest human preference win rates across each use-case?",
                },
            ],
        }
    ],
)

print(message.content)

Elabora batch di documenti

Usa la Message Batches API per elaborare molti PDF in un’unica richiesta:

import base64
import httpx2

# Per prima cosa, carica e codifica il PDF
pdf_url = "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf"
pdf_data = base64.standard_b64encode(
    httpx2.get(pdf_url, follow_redirects=True).content
).decode("utf-8")

# Crea un batch di richieste che usano il documento
client = anthropic.Anthropic()
message_batch = client.messages.batches.create(
    requests=[
        {
            "custom_id": "my-first-request",
            "params": {
                "model": "claude-opus-5-5",
                "max_tokens": 1024,
                "messages": [
                    {
                        "role": "user",
                        "content": [
                            {
                                "type": "document",
                                "source": {
                                    "type": "base64",
                                    "media_type": "application/pdf",
                                    "data": pdf_data,
                                },
                            },
                            {
                                "type": "text",
                                "text": "Which model has the highest human preference win rates across each use-case?",
                            },
                        ],
                    }
                ],
            },
        },
        {
            "custom_id": "my-second-request",
            "params": {
                "model": "claude-opus-5-5",
                "max_tokens": 1024,
                "messages": [
                    {
                        "role": "user",
                        "content": [
                            {
                                "type": "document",
                                "source": {
                                    "type": "base64",
                                    "media_type": "application/pdf",
                                    "data": pdf_data,
                                },
                            },
                            {
                                "type": "text",
                                "text": "Extract 5 key insights from this document.",
                            },
                        ],
                    }
                ],
            },
        },
    ]
)

print(message_batch)

I batch vengono elaborati in modo asincrono. Per controllare l’avanzamento e recuperare i risultati al termine dell’elaborazione, consulta Elaborazione batch.

Prossimi passi

Scopri come contare i token visivi di un’immagine e quali limitazioni i PDF condividono con gli altri compiti di visione.

Esplora esempi pratici di elaborazione dei PDF nella ricetta del Claude Cookbook.

Consulta la documentazione API completa per il supporto PDF.

Disponibilità

Supporto PDF
API
  • Messages API
  • Managed Agents
Modelli
  • Tutti i modelli

Endpoint applicabili

  • /v1/messages
Conservazione zero dei datiIdoneo

Esclude Modelli coperti

HIPAAIdoneo

L’idoneità HIPAA si applica ai PDF inviati inline tramite la Messages API, non tramite la Files API.

Questa pagina ti è stata utile?