Claude на Amazon Bedrock

Вызов Claude через Bedrock немного отличается от того, как вы вызывали бы Claude при использовании SDK клиента Anthropic. Это руководство проведет вас через процесс выполнения вызова API к Claude на Bedrock на Python или TypeScript.

Обратите внимание, что это руководство предполагает, что вы уже зарегистрировались в учетной записи AWS и настроили программный доступ.

Установка и настройка AWS CLI

1. Установите версию AWS CLI версии 2.13.23 или новее
2. Настройте учетные данные AWS, используя команду AWS configure (см. Настройка AWS CLI) или найдите свои учетные данные, перейдя к "Command line or programmatic access" на панели управления AWS и следуя инструкциям во всплывающем модальном окне.
3. Проверьте, что ваши учетные данные работают:

aws sts get-caller-identity

Установка SDK для доступа к Bedrock

SDK клиента Anthropic поддерживает Bedrock. Вы также можете использовать AWS SDK, такой как boto3, напрямую.

pip install -U "anthropic[bedrock]"

Доступ к Bedrock

Подписка на модели Anthropic

Перейдите в AWS Console > Bedrock > Model Access и запросите доступ к моделям Anthropic. Обратите внимание, что доступность моделей Anthropic варьируется в зависимости от региона. См. документацию AWS для получения последней информации.

Идентификаторы моделей API

Для получения дополнительной информации о региональных и глобальных идентификаторах моделей см. раздел Глобальные и региональные конечные точки ниже.

Список доступных моделей

Следующие примеры показывают, как вывести список всех моделей Claude, доступных через Bedrock:

aws bedrock list-foundation-models --region=us-west-2 --by-provider anthropic --query "modelSummaries[*].modelId"

Выполнение запросов

Следующие примеры показывают, как генерировать текст из Claude на Bedrock:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Аутентификация путем предоставления ключей ниже или использования поставщиков учетных данных AWS по умолчанию, таких как
    # использование ~/.aws/credentials или переменных окружения "AWS_SECRET_ACCESS_KEY" и "AWS_ACCESS_KEY_ID".
    aws_access_key="<access key>",
    aws_secret_key="<secret key>",
    # Временные учетные данные можно использовать с aws_session_token.
    # Подробнее на https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
    aws_session_token="<session_token>",
    # aws_region изменяет регион aws, на который выполняется запрос. По умолчанию мы читаем AWS_REGION,
    # и если это не присутствует, мы по умолчанию используем us-east-1. Обратите внимание, что мы не читаем ~/.aws/config для региона.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="global.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)
print(message.content)

Дополнительные сведения см. в SDK клиента, а официальную документацию Bedrock см. здесь.

Логирование активности

Bedrock предоставляет сервис логирования вызовов, который позволяет клиентам регистрировать подсказки и завершения, связанные с вашим использованием.

Anthropic рекомендует регистрировать вашу активность по крайней мере на основе 30-дневного скользящего окна, чтобы понять вашу активность и исследовать любое потенциальное неправомерное использование.

Поддержка функций

Все функции, которые в настоящее время поддерживаются на Bedrock, вы можете найти здесь.

Поддержка PDF на Bedrock

Поддержка PDF доступна на Amazon Bedrock через API Converse и API InvokeModel. Для получения подробной информации о возможностях и ограничениях обработки PDF см. документацию по поддержке PDF.

Важные соображения для пользователей API Converse:

• Визуальный анализ PDF (диаграммы, изображения, макеты) требует включения цитирования
• Без цитирования доступна только базовая извлечение текста
• Для полного контроля без принудительного цитирования используйте API InvokeModel

Для получения дополнительной информации о двух режимах обработки документов и их ограничениях см. руководство по поддержке PDF.

Контекстное окно на 1 млн токенов

Claude Sonnet 4 и 4.5 поддерживают контекстное окно на 1 млн токенов на Amazon Bedrock.

Глобальные и региональные конечные точки

Начиная с Claude Sonnet 4.5 и всех будущих моделей, Amazon Bedrock предлагает два типа конечных точек:

• Глобальные конечные точки: Динамическая маршрутизация для максимальной доступности
• Региональные конечные точки: Гарантированная маршрутизация данных через определенные географические регионы

Региональные конечные точки включают надбавку в размере 10% к цене глобальных конечных точек.

Когда использовать каждый вариант

Глобальные конечные точки (рекомендуется):

• Обеспечивают максимальную доступность и время безотказной работы
• Динамически маршрутизируют запросы в регионы с доступной емкостью
• Без надбавки к цене
• Лучше всего для приложений, где гибкость размещения данных

Региональные конечные точки (CRIS):

• Маршрутизируют трафик через определенные географические регионы
• Требуются для требований к размещению данных и соответствию нормативным требованиям
• Доступны для США, ЕС, Японии и Австралии
• Надбавка в размере 10% отражает затраты на инфраструктуру для выделенной региональной емкости

Реализация

Использование глобальных конечных точек (по умолчанию для Sonnet 4.5 и 4):

Идентификаторы моделей для Claude Sonnet 4.5 и 4 уже включают префикс global.:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

message = client.messages.create(
    model="global.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)

Использование региональных конечных точек (CRIS):

Чтобы использовать региональные конечные точки, удалите префикс global. из идентификатора модели:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

# Использование региональной конечной точки США (CRIS)
message = client.messages.create(
    model="anthropic.claude-sonnet-4-5-20250929-v1:0",  # Без префикса global.
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)

Дополнительные ресурсы

• Ценообразование AWS Bedrock: aws.amazon.com/bedrock/pricing
• Документация по ценообразованию AWS: Руководство по ценообразованию Bedrock
• Блог AWS: Introducing Claude Sonnet 4.5 in Amazon Bedrock
• Детали ценообразования Anthropic: Документация по ценообразованию