Ora puoi chiedere a Claude informazioni su qualsiasi testo, immagini, grafici e tabelle nei PDF che fornisci. Alcuni casi d’uso di esempio:

  • Analizzare report finanziari e comprendere grafici/tabelle
  • Estrarre informazioni chiave da documenti legali
  • Assistenza alla traduzione per documenti
  • Convertire informazioni di documenti in formati strutturati

Prima di iniziare

Verifica i requisiti PDF

Claude funziona con qualsiasi PDF standard. Tuttavia, dovresti assicurarti che la dimensione della tua richiesta soddisfi questi requisiti quando usi il supporto PDF:

RequisitoLimite
Dimensione massima richiesta32MB
Pagine massime per richiesta100
FormatoPDF standard (senza password/crittografia)

Si prega di notare che entrambi i limiti si applicano all’intero payload della richiesta, incluso qualsiasi altro contenuto inviato insieme ai PDF.

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

Piattaforme e modelli supportati

Il supporto PDF è attualmente supportato tramite accesso API diretto e Google Vertex AI su:

  • Claude Opus 4 (claude-opus-4-20250514)
  • Claude Sonnet 4 (claude-sonnet-4-20250514)
  • Claude Sonnet 3.7 (claude-3-7-sonnet-20250219)
  • Modelli Claude Sonnet 3.5 (claude-3-5-sonnet-20241022, claude-3-5-sonnet-20240620)
  • Claude Haiku 3.5 (claude-3-5-haiku-20241022)

Questa funzionalità sarà supportata su Amazon Bedrock presto.

Per file non PDF come .csv, .xlsx, .docx, .md, o .txt, vedi Lavorare con altri formati di file.


Elabora PDF con Claude

Invia la tua prima richiesta PDF

Iniziamo con un esempio semplice usando l’API Messages. Puoi fornire PDF a Claude in tre modi:

  1. Come riferimento URL a un PDF ospitato online
  2. Come PDF codificato in base64 in blocchi di contenuto document
  3. Tramite un file_id dall’API Files

Opzione 1: Documento PDF basato su URL

L’approccio più semplice è fare riferimento a un PDF direttamente da un URL:

 curl https://api.anthropic.com/v1/messages \
   -H "content-type: application/json" \
   -H "x-api-key: $ANTHROPIC_API_KEY" \
   -H "anthropic-version: 2023-06-01" \
   -d '{
     "model": "claude-opus-4-20250514",
     "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?"
         }]
     }]
 }'

Opzione 2: Documento PDF codificato in base64

Se hai bisogno di inviare PDF dal tuo sistema locale o quando un URL non è disponibile:

# Method 1: Fetch and encode a remote PDF
curl -s "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf" | base64 | tr -d '\n' > pdf_base64.txt

# Method 2: Encode a local PDF file
# base64 document.pdf | tr -d '\n' > pdf_base64.txt

# Create a JSON request file using the pdf_base64.txt content
jq -n --rawfile PDF_BASE64 pdf_base64.txt '{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [{
        "role": "user",
        "content": [{
            "type": "document",
            "source": {
                "type": "base64",
                "media_type": "application/pdf",
                "data": $PDF_BASE64
            }
        },
        {
            "type": "text",
            "text": "What are the key findings in this document?"
        }]
    }]
}' > request.json

# Send the API request using the JSON file
curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d @request.json

Opzione 3: API Files

Per PDF che userai ripetutamente, o quando vuoi evitare il sovraccarico di codifica, usa l’API Files:

# First, upload your PDF to the Files API
curl -X POST https://api.anthropic.com/v1/files \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14" \
  -F "file=@document.pdf"

# Then use the returned file_id in your message
curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14" \
  -d '{
    "model": "claude-opus-4-20250514", 
    "max_tokens": 1024,
    "messages": [{
      "role": "user",
      "content": [{
        "type": "document",
        "source": {
          "type": "file",
          "file_id": "file_abc123"
        }
      },
      {
        "type": "text",
        "text": "What are the key findings in this document?"
      }]
    }]
  }'

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 testo di ogni pagina viene estratto e fornito insieme all’immagine di ogni pagina.
2

Claude analizza sia il testo che le immagini per comprendere meglio il documento.

  • I documenti sono forniti come combinazione di testo e immagini per l’analisi.
  • Questo permette agli utenti di chiedere approfondimenti sugli elementi visivi di un PDF, come grafici, diagrammi e altri contenuti non testuali.
3

Claude risponde, facendo riferimento ai contenuti del PDF se pertinente.

Claude può fare riferimento sia al contenuto testuale che visivo quando risponde. Puoi migliorare ulteriormente le prestazioni integrando il supporto PDF con:

  • Prompt caching: Per migliorare le prestazioni per analisi ripetute.
  • Elaborazione batch: Per l’elaborazione di documenti ad alto volume.
  • Uso di strumenti: Per estrarre informazioni specifiche dai documenti da utilizzare come input per strumenti.

Stima i tuoi costi

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

  • Costi token di testo: Ogni pagina utilizza tipicamente 1.500-3.000 token per pagina a seconda della densità del contenuto. Si applica il prezzo API standard senza costi aggiuntivi per PDF.
  • Costi token di immagine: Poiché ogni pagina viene convertita in un’immagine, si applicano gli stessi calcoli di costo basati su immagini.

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


Ottimizza l’elaborazione PDF

Migliora le prestazioni

Segui queste migliori pratiche 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 numeri di pagina logici (dal visualizzatore PDF) nei prompt
  • Dividi PDF grandi in blocchi quando necessario
  • Abilita il prompt caching per analisi ripetute

Scala la tua implementazione

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

Usa il prompt caching

Memorizza in cache i PDF per migliorare le prestazioni su query ripetute:

# Create a JSON request file using the pdf_base64.txt content
jq -n --rawfile PDF_BASE64 pdf_base64.txt '{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [{
        "role": "user",
        "content": [{
            "type": "document",
            "source": {
                "type": "base64",
                "media_type": "application/pdf",
                "data": $PDF_BASE64
            },
            "cache_control": {
              "type": "ephemeral"
            }
        },
        {
            "type": "text",
            "text": "Which model has the highest human preference win rates across each use-case?"
        }]
    }]
}' > request.json

# Then make the API call using the JSON file
curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d @request.json

Elabora batch di documenti

Usa l’API Message Batches per flussi di lavoro ad alto volume:

# Create a JSON request file using the pdf_base64.txt content
jq -n --rawfile PDF_BASE64 pdf_base64.txt '
{
  "requests": [
      {
          "custom_id": "my-first-request",
          "params": {
              "model": "claude-opus-4-20250514",
              "max_tokens": 1024,
              "messages": [
                {
                    "role": "user",
                    "content": [
                        {
                            "type": "document",
                            "source": {
 "type": "base64",
 "media_type": "application/pdf",
 "data": $PDF_BASE64
                            }
                        },
                        {
                            "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-4-20250514",
              "max_tokens": 1024,
              "messages": [
                {
                    "role": "user",
                    "content": [
                        {
                            "type": "document",
                            "source": {
 "type": "base64",
 "media_type": "application/pdf",
 "data": $PDF_BASE64
                            }
                        },
                        {
                            "type": "text",
                            "text": "Extract 5 key insights from this document."
                        }
                    ]
                }
              ]
          }
      }
  ]
}
' > request.json

# Then make the API call using the JSON file
curl https://api.anthropic.com/v1/messages/batches \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d @request.json

Prossimi passi