Claude на Amazon Bedrock

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

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

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

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

Shell

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

Модель	Базовый идентификатор модели Bedrock	`global`	`us`	`eu`	`jp`	`apac`
Claude Sonnet 4.5	anthropic.claude-sonnet-4-5-20250929-v1:0	Yes	Yes	Yes	Yes	No
Claude Sonnet 4	anthropic.claude-sonnet-4-20250514-v1:0	Yes	Yes	Yes	No	Yes
Claude Sonnet 3.7 ⚠️	anthropic.claude-3-7-sonnet-20250219-v1:0

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

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

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

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

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

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

См. наши SDK клиентов для получения дополнительной информации, а также официальную документацию Bedrock здесь.

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

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

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

Включение этого сервиса не дает AWS или Anthropic никакого доступа к вашему контенту.

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

Все функции, которые в настоящее время поддерживаются на 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.

Контекстное окно в 1 млн токенов в настоящее время находится в бета-версии. Чтобы использовать расширенное контекстное окно, включите заголовок бета-версии context-1m-2025-08-07 в ваши запросы API Bedrock.

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

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

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

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

Это применяется только к Claude Sonnet 4.5 и будущим моделям. Более старые модели (Claude Sonnet 4, Opus 4 и более ранние) сохраняют свои существующие структуры ценообразования.

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

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

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

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

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

Реализация

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

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

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

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

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

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

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)

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"}]
)

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"}]
)