Поддержка 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, какого он размера и как часто вы его используете:
- PDF, размещённый в интернете: ссылайтесь на него по URL (Вариант 1: PDF-документ по URL).
- PDF в вашей локальной системе или без URL: отправьте его в виде данных в кодировке base64 (Вариант 2: PDF-документ в кодировке base64).
- Большой 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:
{
"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, происходят следующие шаги:
Система извлекает содержимое документа.
- Система преобразует каждую страницу документа в изображение.
- Система извлекает текст с каждой страницы и предоставляет его вместе с изображением этой страницы.
Claude анализирует как текст, так и изображения.
- Claude получает каждый документ в виде комбинации текста и изображений.
- Поскольку Claude получает изображение каждой страницы, вы можете запрашивать сведения о визуальных элементах PDF, таких как диаграммы, схемы и другое нетекстовое содержимое.
Claude использует содержимое PDF в своём ответе, если это уместно.
В своём ответе Claude может опираться как на текстовое, так и на визуальное содержимое.
Оцените свои затраты
Количество токенов PDF-файла зависит от общего объёма текста, извлечённого из документа, и количества страниц:
- Стоимость текстовых токенов: каждая страница обычно использует 1 500–3 000 токенов в зависимости от плотности содержимого. Применяются стандартные цены API без дополнительной платы за PDF.
- Стоимость токенов изображений: изображение каждой страницы использует не более 1 568 визуальных токенов на любой модели, поскольку API вписывает изображения страниц в ограничения стандартного уровня разрешения. О том, как подсчитать визуальные токены изображения, см. Разрешение и стоимость в токенах.
Вы можете использовать подсчёт токенов для оценки затрат на ваши конкретные PDF.
Оптимизация обработки PDF
Вы можете сочетать поддержку PDF с другими функциями:
- Использование кэширования подсказок — для повышения производительности при повторном анализе.
- Обработка пакетов документов — для работы с документами в больших объёмах.
- Использование инструментов — чтобы Claude извлекал конкретную информацию из документов для использования в качестве входных данных инструментов.
Повышение производительности
Следуйте этим рекомендациям для достижения оптимальных результатов:
- Размещайте 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.
Доступность
Claude API
- API
- Messages API
- Managed Agents
- Модели
- Все модели
Amazon Bedrock
- API
- Messages API
- Модели
- Все модели
- Примечание
Только источники в base64.
Amazon Bedrock (bedrock-runtime)
- API
- Messages API
- Модели
- Все модели
- Примечание
Только источники в base64.
Claude Platform on AWS
- API
- Messages API
- Managed Agents
- Модели
- Все модели
Claude Models on Google Cloud (Anthropic managed)
- API
- Messages API
- Managed Agents
- Модели
- Все модели
Claude Models on Google Cloud (Google managed)
- API
- Messages API
- Модели
- Все модели
- Примечание
Только источники в base64.
Microsoft Foundry
- API
- Messages API
- Модели
- Все модели
- Примечание
Для источников
file_idтребуется развёртывание, размещённое в Anthropic.
Обработка данных
Обзор обработки данныхПрименимые конечные точки
/v1/messages
Кроме Охватываемые модели
Применимость HIPAA распространяется на PDF-файлы, отправленные непосредственно в запросе через Messages API, а не через Files API.
Эта страница была полезной?