Claude Platform Docs
СообщенияРабота с файлами

Поддержка PDF

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

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

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

Перед началом работы

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

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

ТребованиеОграничение
Максимальный размер запроса128 МБ в собственном Claude API (зависит от платформы; см. ограничения размера запроса)
Максимальное количество страниц в запросе600 (100, если контекстное окно запроса меньше 1 млн токенов)
ФорматСтандартный PDF (без паролей/шифрования)

Оба ограничения относятся ко всей полезной нагрузке запроса, включая любое другое содержимое, отправляемое вместе с PDF. Для больших PDF рассмотрите возможность загрузки через Files API и ссылки по file_id, чтобы полезная нагрузка запросов оставалась небольшой.

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

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

Все активные модели поддерживают обработку PDF.

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

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

Начните с примера, использующего Messages API. Чтобы передать PDF Claude, отправьте его в блоке содержимого documentДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. с одним из трёх видов источника. Какие виды вы можете использовать, зависит от вашей платформы (см. Доступность). Среди доступных видов выбирайте в зависимости от того, где находится PDF, какого он размера и как часто вы его используете:

  1. PDF, размещённый в интернете: ссылайтесь на него по URL (Вариант 1: PDF-документ по URL).
  2. PDF в вашей локальной системе или без URL: отправьте его в виде данных в кодировке base64 (Вариант 2: PDF-документ в кодировке base64).
  3. Большой PDF или PDF, который вы будете использовать многократно: загрузите его с помощью Files API и ссылайтесь на него по file_id (Вариант 3: Files API).

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

Ссылайтесь на PDF по его 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)

Ответ возвращает анализ Claude в виде текстовых блоков в content, а потребление токенов — в 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
  }
}

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

Отправьте PDF в виде данных в кодировке base64 непосредственно в запросе. Большинство следующих примеров скачивают образец PDF и кодируют его, поэтому им не нужен локальный файл. Чтобы отправить локальный файл в этих примерах, замените строки, которые скачивают и кодируют PDF, закомментированными строками:

import base64
import httpx2

# Сначала загрузите и закодируйте 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")

# Альтернатива: загрузка из локального файла
# with open("document.pdf", "rb") as f:
#     pdf_data = base64.standard_b64encode(f.read()).decode("utf-8")

# Отправка в Claude с использованием кодировки 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)

Вариант 3: Files API

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

client = anthropic.Anthropic()

# Загрузите PDF-файл
with open("/path/to/document.pdf", "rb") as f:
    file_upload = client.files.upload(file=("document.pdf", f, "application/pdf"))

# Используйте загруженный файл в сообщении
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)

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

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

  1. Система извлекает содержимое документа.

    • Система преобразует каждую страницу документа в изображение.
    • Система извлекает текст с каждой страницы и предоставляет его вместе с изображением этой страницы.
  2. Claude анализирует как текст, так и изображения.

    • Claude получает каждый документ в виде комбинации текста и изображений.
    • Поскольку Claude получает изображение каждой страницы, вы можете запрашивать сведения о визуальных элементах PDF, таких как диаграммы, схемы и другое нетекстовое содержимое.
  3. Claude использует содержимое PDF в своём ответе, если это уместно.

    В своём ответе Claude может опираться как на текстовое, так и на визуальное содержимое.

Оцените свои затраты

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

  • Стоимость текстовых токенов: каждая страница обычно использует 1 500–3 000 токенов в зависимости от плотности содержимого. Применяются стандартные цены API без дополнительной платы за PDF.
  • Стоимость токенов изображений: изображение каждой страницы использует не более 1 568 визуальных токенов на любой модели, поскольку API вписывает изображения страниц в ограничения стандартного уровня разрешения. О том, как подсчитать визуальные токены изображения, см. Разрешение и стоимость в токенах.

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

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

Вы можете сочетать поддержку PDF с другими функциями:

Повышение производительности

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

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

Масштабирование вашей реализации

Для обработки больших объёмов рассмотрите следующие подходы:

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

Кэшируйте PDF с помощью «prompt caching» (кэширование подсказок), чтобы повысить производительность при повторных запросах:

import base64
import httpx2

# Сначала загрузите и закодируйте 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")

# Создайте сообщение с кэшированным документом
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)

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

Используйте Message Batches API для обработки множества PDF в одном запросе:

import base64
import httpx2

# Сначала загрузите и закодируйте 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")

# Создайте пакет запросов, использующих этот документ
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)

Пакеты обрабатываются асинхронно. Чтобы проверить ход выполнения и получить результаты после завершения обработки, см. Пакетная обработка.

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

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

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

См. полную документацию API по поддержке PDF.

Доступность

Поддержка PDF
API
  • Messages API
  • Managed Agents
Модели
  • Все модели

Обработка данных

Обзор обработки данных

Применимые конечные точки

  • /v1/messages
Нулевое хранение данныхДопускается

Кроме Охватываемые модели

HIPAAДопускается

Применимость HIPAA распространяется на PDF-файлы, отправленные непосредственно в запросе через Messages API, а не через Files API.

Эта страница была полезной?