Suporte a PDF

Agora você pode perguntar ao Claude sobre qualquer texto, imagens, gráficos e tabelas em PDFs que você fornecer. Alguns casos de uso de exemplo:

Analisar relatórios financeiros e compreender gráficos/tabelas
Extrair informações-chave de documentos legais
Assistência de tradução para documentos
Converter informações de documentos em formatos estruturados

Antes de começar

Verificar requisitos de PDF

Claude funciona com qualquer PDF padrão. No entanto, você deve garantir que o tamanho da sua solicitação atenda a esses requisitos ao usar o suporte a PDF:

Requisito	Limite
Tamanho máximo da solicitação	32MB
Máximo de páginas por solicitação	100
Formato	PDF padrão (sem senhas/criptografia)

Observe que ambos os limites são para toda a carga útil da solicitação, incluindo qualquer outro conteúdo enviado junto com PDFs. Como o suporte a PDF depende das capacidades de visão do Claude, está sujeito às mesmas limitações e considerações que outras tarefas de visão.

Plataformas e modelos suportados

O suporte a PDF é atualmente suportado via acesso direto à API e Google Vertex AI em:

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

O suporte a PDF agora está disponível no Amazon Bedrock com as seguintes considerações:

Suporte a PDF do Amazon Bedrock

Ao usar o suporte a PDF através da API Converse do Amazon Bedrock, existem dois modos distintos de processamento de documentos:

Importante: Para acessar as capacidades completas de compreensão visual de PDF do Claude na API Converse, você deve habilitar citações. Sem citações habilitadas, a API volta para extração básica de texto apenas. Saiba mais sobre trabalhar com citações.

Modos de Processamento de Documentos

Converse Document Chat (Modo original - Extração de texto apenas)
- Fornece extração básica de texto de PDFs
- Não pode analisar imagens, gráficos ou layouts visuais dentro de PDFs
- Usa aproximadamente 1.000 tokens para um PDF de 3 páginas
- Usado automaticamente quando citações não estão habilitadas
Claude PDF Chat (Novo modo - Compreensão visual completa)
- Fornece análise visual completa de PDFs
- Pode compreender e analisar gráficos, diagramas, imagens e layouts visuais
- Processa cada página como texto e imagem para compreensão abrangente
- Usa aproximadamente 7.000 tokens para um PDF de 3 páginas
- Requer citações habilitadas na API Converse

Limitações Principais

API Converse: Análise visual de PDF requer citações habilitadas. Atualmente não há opção para usar análise visual sem citações (diferente da API InvokeModel).
API InvokeModel: Fornece controle total sobre processamento de PDF sem citações forçadas.

Problemas Comuns

Se clientes relatarem que Claude não está vendo imagens ou gráficos em seus PDFs ao usar a API Converse, eles provavelmente precisam habilitar a flag de citações. Sem ela, Converse volta para extração básica de texto apenas.

Esta é uma restrição conhecida com a API Converse que estamos trabalhando para resolver. Para aplicações que requerem análise visual de PDF sem citações, considere usar a API InvokeModel em vez disso.

Para arquivos não-PDF como .csv, .xlsx, .docx, .md, ou .txt, veja Trabalhando com outros formatos de arquivo.

Processar PDFs com Claude

Envie sua primeira solicitação de PDF

Vamos começar com um exemplo simples usando a API Messages. Você pode fornecer PDFs ao Claude de três maneiras:

Como uma referência de URL para um PDF hospedado online
Como um PDF codificado em base64 em blocos de conteúdo document
Por um file_id da API Files

Opção 1: Documento PDF baseado em URL

A abordagem mais simples é referenciar um PDF diretamente de uma 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": "Quais são as principais descobertas neste documento?"
         }]
     }]
 }'

Opção 2: Documento PDF codificado em base64

Se você precisar enviar PDFs do seu sistema local ou quando uma URL não estiver disponível:

# Método 1: Buscar e codificar um PDF remoto
curl -s "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf" | base64 | tr -d '\n' > pdf_base64.txt

# Método 2: Codificar um arquivo PDF local
# base64 document.pdf | tr -d '\n' > pdf_base64.txt

# Criar um arquivo de solicitação JSON usando o conteúdo pdf_base64.txt
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": "Quais são as principais descobertas neste documento?"
        }]
    }]
}' > request.json

# Enviar a solicitação da API usando o arquivo JSON
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

Opção 3: API Files

Para PDFs que você usará repetidamente, ou quando quiser evitar sobrecarga de codificação, use a API Files:

# Primeiro, faça upload do seu PDF para a API Files
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"

# Então use o file_id retornado em sua mensagem
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": "Quais são as principais descobertas neste documento?"
      }]
    }]
  }'

Como funciona o suporte a PDF

Quando você envia um PDF para Claude, os seguintes passos ocorrem:

O sistema extrai o conteúdo do documento.

O sistema converte cada página do documento em uma imagem.
O texto de cada página é extraído e fornecido junto com a imagem de cada página.

Claude analisa tanto o texto quanto as imagens para melhor compreender o documento.

Documentos são fornecidos como uma combinação de texto e imagens para análise.
Isso permite que usuários peçam insights sobre elementos visuais de um PDF, como gráficos, diagramas e outro conteúdo não textual.

Claude responde, referenciando o conteúdo do PDF se relevante.

Claude pode referenciar tanto conteúdo textual quanto visual quando responde. Você pode melhorar ainda mais o desempenho integrando o suporte a PDF com:

Cache de prompt: Para melhorar o desempenho para análise repetida.
Processamento em lote: Para processamento de documentos de alto volume.
Uso de ferramentas: Para extrair informações específicas de documentos para uso como entradas de ferramentas.

Estime seus custos

A contagem de tokens de um arquivo PDF depende do texto total extraído do documento, bem como do número de páginas:

Custos de tokens de texto: Cada página normalmente usa 1.500-3.000 tokens por página dependendo da densidade do conteúdo. Preços padrão da API se aplicam sem taxas adicionais de PDF.
Custos de tokens de imagem: Como cada página é convertida em uma imagem, os mesmos cálculos de custo baseados em imagem são aplicados.

Você pode usar contagem de tokens para estimar custos para seus PDFs específicos.

Otimizar processamento de PDF

Melhorar desempenho

Siga essas melhores práticas para resultados ótimos:

Coloque PDFs antes do texto em suas solicitações
Use fontes padrão
Garanta que o texto seja claro e legível
Gire páginas para orientação vertical adequada
Use números de página lógicos (do visualizador de PDF) em prompts
Divida PDFs grandes em pedaços quando necessário
Habilite cache de prompt para análise repetida

Escalar sua implementação

Para processamento de alto volume, considere essas abordagens:

Use cache de prompt

Cache PDFs para melhorar desempenho em consultas repetidas:

# Criar um arquivo de solicitação JSON usando o conteúdo pdf_base64.txt
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": "Qual modelo tem as maiores taxas de vitória de preferência humana em cada caso de uso?"
        }]
    }]
}' > request.json

# Então fazer a chamada da API usando o arquivo JSON
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

Processar lotes de documentos

Use a API Message Batches para fluxos de trabalho de alto volume:

# Criar um arquivo de solicitação JSON usando o conteúdo pdf_base64.txt
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": "Qual modelo tem as maiores taxas de vitória de preferência humana em cada caso de uso?"
                        }
                    ]
                }
              ]
          }
      },
      {
          "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": "Extraia 5 insights principais deste documento."
                        }
                    ]
                }
              ]
          }
      }
  ]
}
' > request.json

# Então fazer a chamada da API usando o arquivo JSON
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

Próximos passos

Experimente exemplos de PDF

Explore exemplos práticos de processamento de PDF em nossa receita de cookbook.

Ver referência da API

Veja a documentação completa da API para suporte a PDF.

Primeiros passos

Modelos e preços

Saiba mais sobre Claude

Capacidades

Ferramentas

Protocolo de Contexto do Modelo (MCP)

Casos de uso

Engenharia de prompts

Testar e avaliar

Fortalecer proteções

Centro legal

Antes de começar

Verificar requisitos de PDF

Plataformas e modelos suportados

Suporte a PDF do Amazon Bedrock

Modos de Processamento de Documentos

Limitações Principais

Problemas Comuns

Processar PDFs com Claude

Envie sua primeira solicitação de PDF

Opção 1: Documento PDF baseado em URL

Opção 2: Documento PDF codificado em base64

Opção 3: API Files

Como funciona o suporte a PDF

Estime seus custos

Otimizar processamento de PDF

Melhorar desempenho

Escalar sua implementação

Use cache de prompt

Processar lotes de documentos

Próximos passos

Experimente exemplos de PDF

Ver referência da API

Primeiros passos

Modelos e preços

Saiba mais sobre Claude

Capacidades

Ferramentas

Protocolo de Contexto do Modelo (MCP)

Casos de uso

Engenharia de prompts

Testar e avaliar

Fortalecer proteções

Centro legal

​Antes de começar

​Verificar requisitos de PDF

​Plataformas e modelos suportados

​Suporte a PDF do Amazon Bedrock

​Modos de Processamento de Documentos

​Limitações Principais

​Problemas Comuns

​Processar PDFs com Claude

​Envie sua primeira solicitação de PDF

​Opção 1: Documento PDF baseado em URL

​Opção 2: Documento PDF codificado em base64

​Opção 3: API Files

​Como funciona o suporte a PDF

​Estime seus custos

​Otimizar processamento de PDF

​Melhorar desempenho

​Escalar sua implementação

​Use cache de prompt

​Processar lotes de documentos

​Próximos passos

Experimente exemplos de PDF

Ver referência da API

Antes de começar

Verificar requisitos de PDF

Plataformas e modelos suportados

Suporte a PDF do Amazon Bedrock

Modos de Processamento de Documentos

Limitações Principais

Problemas Comuns

Processar PDFs com Claude

Envie sua primeira solicitação de PDF

Opção 1: Documento PDF baseado em URL

Opção 2: Documento PDF codificado em base64

Opção 3: API Files

Como funciona o suporte a PDF

Estime seus custos

Otimizar processamento de PDF

Melhorar desempenho

Escalar sua implementação

Use cache de prompt

Processar lotes de documentos

Próximos passos