Capacidades

Suporte a PDF

Processe PDFs com Claude. Extraia texto, analise gráficos e compreenda conteúdo visual de seus documentos.

Agora você pode fazer perguntas ao Claude sobre qualquer texto, imagens, gráficos e tabelas em PDFs que você forneça. Alguns casos de uso de exemplo:

Analisando relatórios financeiros e compreendendo gráficos/tabelas
Extraindo informações-chave de documentos legais
Assistência de tradução para documentos
Convertendo 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 suporte a PDF:

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

Observe que ambos os limites estão na carga útil da solicitação inteira, 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. Todos os modelos ativos suportam processamento de PDF.

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

Suporte a PDF do Amazon Bedrock

Ao usar 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 ativar citações. Sem citações ativadas, 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 ativadas
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 ativadas na API Converse

Limitações Principais

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

Problemas Comuns

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

Esta é uma restrição conhecida da 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.

Processe 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-6",
     "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?"
         }]
     }]
 }'

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:

# 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-6",
    "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

Opção 3: API Files

Para PDFs que você usará repetidamente, ou quando quiser evitar overhead de codificação, use a 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 "[email protected]"

# 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-6", 
    "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?"
      }]
    }]
  }'

Como funciona o suporte a PDF

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

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 compreender melhor o documento.
- Os documentos são fornecidos como uma combinação de texto e imagens para análise.
- Isso permite que os 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 conteúdo textual e visual ao responder. Você pode melhorar ainda mais o desempenho integrando suporte a PDF com:
- Prompt caching: Para melhorar o desempenho para análise repetida.
- Batch processing: Para processamento de documentos em alto volume.
- Tool use: 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 de conteúdo. O preço padrão da API se aplica 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.

Otimize o processamento de PDF

Melhore o desempenho

Siga essas melhores práticas para resultados ideais:

Coloque PDFs antes de texto em suas solicitações
Use fontes padrão
Garanta que o texto seja claro e legível
Gire as 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
Ative prompt caching para análise repetida

Dimensione sua implementação

Para processamento de alto volume, considere estas abordagens:

Use cache de prompt

Armazene em cache PDFs para melhorar o desempenho em consultas repetidas:

# Crie um arquivo de solicitação JSON usando o conteúdo de pdf_base64.txt
jq -n --rawfile PDF_BASE64 pdf_base64.txt '{
    "model": "claude-opus-4-6",
    "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

# Em seguida, faça 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

Processe lotes de documentos

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

# Crie um arquivo de solicitação JSON usando o conteúdo de pdf_base64.txt
jq -n --rawfile PDF_BASE64 pdf_base64.txt '
{
  "requests": [
      {
          "custom_id": "my-first-request",
          "params": {
              "model": "claude-opus-4-6",
              "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-6",
              "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

# Em seguida, faça 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óximas etapas

Experimente exemplos de PDF

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

Visualize referência da API

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

Was this page helpful?

Capacidades

Suporte a PDF

Processe PDFs com Claude. Extraia texto, analise gráficos e compreenda conteúdo visual de seus documentos.

Agora você pode fazer perguntas ao Claude sobre qualquer texto, imagens, gráficos e tabelas em PDFs que você forneça. Alguns casos de uso de exemplo:

Analisando relatórios financeiros e compreendendo gráficos/tabelas
Extraindo informações-chave de documentos legais
Assistência de tradução para documentos
Convertendo 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 suporte a PDF:

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

Observe que ambos os limites estão na carga útil da solicitação inteira, 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. Todos os modelos ativos suportam processamento de PDF.

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

Suporte a PDF do Amazon Bedrock

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

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 ativadas
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 ativadas na API Converse

Limitações Principais

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

Problemas Comuns

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

Processe 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-6",
     "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?"
         }]
     }]
 }'

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:

# 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-6",
    "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

Opção 3: API Files

Para PDFs que você usará repetidamente, ou quando quiser evitar overhead de codificação, use a 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 "[email protected]"

# 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-6", 
    "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?"
      }]
    }]
  }'

Como funciona o suporte a PDF

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

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 compreender melhor o documento.
- Os documentos são fornecidos como uma combinação de texto e imagens para análise.
- Isso permite que os 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 conteúdo textual e visual ao responder. Você pode melhorar ainda mais o desempenho integrando suporte a PDF com:
- Prompt caching: Para melhorar o desempenho para análise repetida.
- Batch processing: Para processamento de documentos em alto volume.
- Tool use: 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 de conteúdo. O preço padrão da API se aplica 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.

Otimize o processamento de PDF

Melhore o desempenho

Siga essas melhores práticas para resultados ideais:

Coloque PDFs antes de texto em suas solicitações
Use fontes padrão
Garanta que o texto seja claro e legível
Gire as 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
Ative prompt caching para análise repetida

Dimensione sua implementação

Para processamento de alto volume, considere estas abordagens:

Use cache de prompt

Armazene em cache PDFs para melhorar o desempenho em consultas repetidas:

# Crie um arquivo de solicitação JSON usando o conteúdo de pdf_base64.txt
jq -n --rawfile PDF_BASE64 pdf_base64.txt '{
    "model": "claude-opus-4-6",
    "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

# Em seguida, faça 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

Processe lotes de documentos

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

# Crie um arquivo de solicitação JSON usando o conteúdo de pdf_base64.txt
jq -n --rawfile PDF_BASE64 pdf_base64.txt '
{
  "requests": [
      {
          "custom_id": "my-first-request",
          "params": {
              "model": "claude-opus-4-6",
              "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-6",
              "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

# Em seguida, faça 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óximas etapas

Experimente exemplos de PDF

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

Visualize referência da API

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

Was this page helpful?