Возможности модели

Поддержка PDF

Обрабатывайте PDF с помощью Claude. Извлекайте текст, анализируйте диаграммы и понимайте визуальное содержимое ваших документов.

Теперь вы можете задавать Claude вопросы о любом тексте, изображениях, диаграммах и таблицах в предоставленных вами PDF. Некоторые примеры использования:

Анализ финансовых отчётов и понимание диаграмм/таблиц
Извлечение ключевой информации из юридических документов
Помощь в переводе документов
Преобразование информации из документов в структурированные форматы

Перед началом

Проверьте требования к PDF

Claude работает с любым стандартным PDF. Однако при использовании поддержки PDF следует убедиться, что размер вашего запроса соответствует этим требованиям:

Требование	Лимит
Максимальный размер запроса	32 МБ
Максимальное количество страниц на запрос	100
Формат	Стандартный PDF (без паролей/шифрования)

Обратите внимание, что оба лимита применяются ко всему полезному грузу запроса, включая любое другое содержимое, отправляемое вместе с PDF.

Поскольку поддержка PDF основана на возможностях зрения Claude, она подчиняется тем же ограничениям и соображениям, что и другие задачи зрения.

Поддерживаемые платформы и модели

Поддержка PDF в настоящее время поддерживается через прямой доступ к API и Google Vertex AI. Все активные модели поддерживают обработку PDF.

Поддержка PDF теперь доступна на Amazon Bedrock со следующими соображениями:

Поддержка PDF в Amazon Bedrock

При использовании поддержки PDF через Converse API Amazon Bedrock существует два различных режима обработки документов:

Важно: Для доступа к полным возможностям визуального понимания PDF в Claude в Converse API необходимо включить цитирования. Без включённых цитирований API переходит в режим базового извлечения текста только. Узнайте больше о работе с цитированиями.

Режимы обработки документов

Converse Document Chat (Исходный режим - только извлечение текста)
- Обеспечивает базовое извлечение текста из PDF
- Не может анализировать изображения, диаграммы или визуальные макеты в PDF
- Использует примерно 1000 токенов для 3-страничного PDF
- Автоматически используется, когда цитирования не включены
Claude PDF Chat (Новый режим - полное визуальное понимание)
- Обеспечивает полный визуальный анализ PDF
- Может понимать и анализировать диаграммы, графики, изображения и визуальные макеты
- Обрабатывает каждую страницу как текст и изображение для комплексного понимания
- Использует примерно 7000 токенов для 3-страничного PDF
- Требует включения цитирований в Converse API

Ключевые ограничения

Converse API: Визуальный анализ PDF требует включения цитирований. В настоящее время нет возможности использовать визуальный анализ без цитирований (в отличие от InvokeModel API).
InvokeModel API: Обеспечивает полный контроль над обработкой PDF без принудительных цитирований.

Распространённые проблемы

Если клиенты сообщают, что Claude не видит изображения или диаграммы в их PDF при использовании Converse API, им, вероятно, нужно включить флаг цитирований. Без него Converse переходит в режим базового извлечения текста только.

Это известное ограничение Converse API, над которым мы работаем. Для приложений, требующих визуального анализа PDF без цитирований, рассмотрите использование InvokeModel API вместо этого.

Для файлов, отличных от PDF, таких как .csv, .xlsx, .docx, .md или .txt, см. Работа с другими форматами файлов.

Обработка PDF с помощью Claude

Отправьте свой первый запрос PDF

Давайте начнём с простого примера, используя Messages API. Вы можете предоставить PDF в Claude тремя способами:

Как ссылку на PDF, размещённый в Интернете
Как base64-кодированный PDF в блоках содержимого document
По file_id из Files API

Вариант 1: PDF-документ на основе URL

Самый простой подход — ссылаться на PDF непосредственно с 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?"
         }]
     }]
 }'

Вариант 2: Base64-кодированный PDF-документ

Если вам нужно отправить PDF из вашей локальной системы или когда URL недоступен:

# 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

Вариант 3: Files API

Для PDF, которые вы будете использовать повторно, или когда вы хотите избежать затрат на кодирование, используйте Files API:

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

Как работает поддержка PDF

Когда вы отправляете PDF в Claude, происходят следующие шаги:

Система извлекает содержимое документа.
- Система преобразует каждую страницу документа в изображение.
- Текст с каждой страницы извлекается и предоставляется вместе с изображением каждой страницы.
Claude анализирует как текст, так и изображения для лучшего понимания документа.
- Документы предоставляются как комбинация текста и изображений для анализа.
- Это позволяет пользователям запрашивать информацию о визуальных элементах PDF, таких как диаграммы, схемы и другое нетекстовое содержимое.
Claude отвечает, ссылаясь на содержимое PDF, если это уместно.
Claude может ссылаться как на текстовое, так и на визуальное содержимое при ответе. Вы можете дополнительно улучшить производительность, интегрировав поддержку PDF с:
- Кэширование подсказок: Для улучшения производительности при повторном анализе.
- Пакетная обработка: Для высокообъёмной обработки документов.
- Использование инструментов: Для извлечения конкретной информации из документов для использования в качестве входных данных инструментов.

Оцените ваши затраты

Количество токенов в PDF-файле зависит от общего текста, извлечённого из документа, а также от количества страниц:

Затраты на текстовые токены: Каждая страница обычно использует 1500-3000 токенов на страницу в зависимости от плотности содержимого. Применяется стандартное ценообразование API без дополнительных сборов за PDF.
Затраты на токены изображений: Поскольку каждая страница преобразуется в изображение, применяются те же расчёты затрат на основе изображений.

Вы можете использовать подсчёт токенов для оценки затрат на ваши конкретные PDF.

Оптимизация обработки PDF

Улучшение производительности

Следуйте этим лучшим практикам для оптимальных результатов:

Размещайте PDF перед текстом в ваших запросах
Используйте стандартные шрифты
Убедитесь, что текст чёткий и разборчивый
Поворачивайте страницы в правильную вертикальную ориентацию
Используйте логические номера страниц (из средства просмотра PDF) в подсказках
Разделяйте большие PDF на части при необходимости
Включите кэширование подсказок для повторного анализа

Масштабируйте вашу реализацию

Для высокообъемной обработки рассмотрите эти подходы:

Используйте кэширование подсказок

Кэшируйте PDF-файлы для повышения производительности при повторных запросах:

# Создайте файл JSON-запроса, используя содержимое 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

# Затем выполните вызов API, используя файл 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

Обработка пакетов документов

Используйте API Message Batches для высокообъемных рабочих процессов:

# Создайте файл JSON-запроса, используя содержимое 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

# Затем выполните вызов API, используя файл 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

Следующие шаги

Попробуйте примеры PDF

Изучите практические примеры обработки PDF в нашем рецепте cookbook.

Просмотрите справочник API

Ознакомьтесь с полной документацией API для поддержки PDF.

Was this page helpful?

Возможности модели

Поддержка PDF

Анализ финансовых отчётов и понимание диаграмм/таблиц
Извлечение ключевой информации из юридических документов
Помощь в переводе документов
Преобразование информации из документов в структурированные форматы

Перед началом

Проверьте требования к PDF

Требование	Лимит
Максимальный размер запроса	32 МБ
Максимальное количество страниц на запрос	100
Формат	Стандартный PDF (без паролей/шифрования)

Поддерживаемые платформы и модели

Поддержка PDF теперь доступна на Amazon Bedrock со следующими соображениями:

Поддержка PDF в Amazon Bedrock

При использовании поддержки PDF через Converse API Amazon Bedrock существует два различных режима обработки документов:

Режимы обработки документов

Converse Document Chat (Исходный режим - только извлечение текста)
- Обеспечивает базовое извлечение текста из PDF
- Не может анализировать изображения, диаграммы или визуальные макеты в PDF
- Использует примерно 1000 токенов для 3-страничного PDF
- Автоматически используется, когда цитирования не включены
Claude PDF Chat (Новый режим - полное визуальное понимание)
- Обеспечивает полный визуальный анализ PDF
- Может понимать и анализировать диаграммы, графики, изображения и визуальные макеты
- Обрабатывает каждую страницу как текст и изображение для комплексного понимания
- Использует примерно 7000 токенов для 3-страничного PDF
- Требует включения цитирований в Converse API

Ключевые ограничения

Converse API: Визуальный анализ PDF требует включения цитирований. В настоящее время нет возможности использовать визуальный анализ без цитирований (в отличие от InvokeModel API).
InvokeModel API: Обеспечивает полный контроль над обработкой PDF без принудительных цитирований.

Распространённые проблемы

Для файлов, отличных от PDF, таких как .csv, .xlsx, .docx, .md или .txt, см. Работа с другими форматами файлов.

Обработка PDF с помощью Claude

Отправьте свой первый запрос PDF

Давайте начнём с простого примера, используя Messages API. Вы можете предоставить PDF в Claude тремя способами:

Как ссылку на PDF, размещённый в Интернете
Как base64-кодированный PDF в блоках содержимого document
По file_id из Files API

Вариант 1: PDF-документ на основе URL

Самый простой подход — ссылаться на PDF непосредственно с 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?"
         }]
     }]
 }'

Вариант 2: Base64-кодированный PDF-документ

Если вам нужно отправить PDF из вашей локальной системы или когда URL недоступен:

# 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

Вариант 3: Files API

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

Как работает поддержка PDF

Когда вы отправляете PDF в Claude, происходят следующие шаги:

Система извлекает содержимое документа.
- Система преобразует каждую страницу документа в изображение.
- Текст с каждой страницы извлекается и предоставляется вместе с изображением каждой страницы.
Claude анализирует как текст, так и изображения для лучшего понимания документа.
- Документы предоставляются как комбинация текста и изображений для анализа.
- Это позволяет пользователям запрашивать информацию о визуальных элементах PDF, таких как диаграммы, схемы и другое нетекстовое содержимое.
Claude отвечает, ссылаясь на содержимое PDF, если это уместно.
Claude может ссылаться как на текстовое, так и на визуальное содержимое при ответе. Вы можете дополнительно улучшить производительность, интегрировав поддержку PDF с:
- Кэширование подсказок: Для улучшения производительности при повторном анализе.
- Пакетная обработка: Для высокообъёмной обработки документов.
- Использование инструментов: Для извлечения конкретной информации из документов для использования в качестве входных данных инструментов.

Оцените ваши затраты

Затраты на текстовые токены: Каждая страница обычно использует 1500-3000 токенов на страницу в зависимости от плотности содержимого. Применяется стандартное ценообразование API без дополнительных сборов за PDF.
Затраты на токены изображений: Поскольку каждая страница преобразуется в изображение, применяются те же расчёты затрат на основе изображений.

Вы можете использовать подсчёт токенов для оценки затрат на ваши конкретные PDF.

Оптимизация обработки PDF

Улучшение производительности

Следуйте этим лучшим практикам для оптимальных результатов:

Размещайте PDF перед текстом в ваших запросах
Используйте стандартные шрифты
Убедитесь, что текст чёткий и разборчивый
Поворачивайте страницы в правильную вертикальную ориентацию
Используйте логические номера страниц (из средства просмотра PDF) в подсказках
Разделяйте большие PDF на части при необходимости
Включите кэширование подсказок для повторного анализа

Масштабируйте вашу реализацию

Для высокообъемной обработки рассмотрите эти подходы:

Используйте кэширование подсказок

Кэшируйте PDF-файлы для повышения производительности при повторных запросах:

# Создайте файл JSON-запроса, используя содержимое 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

# Затем выполните вызов API, используя файл 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

Обработка пакетов документов

Используйте API Message Batches для высокообъемных рабочих процессов:

# Создайте файл JSON-запроса, используя содержимое 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

# Затем выполните вызов API, используя файл 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

Следующие шаги

Попробуйте примеры PDF

Изучите практические примеры обработки PDF в нашем рецепте cookbook.

Просмотрите справочник API

Ознакомьтесь с полной документацией API для поддержки PDF.

Was this page helpful?