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, напрямую.

Доступ к 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(
    # Authenticate by either providing the keys below or use the default AWS credential providers, such as
    # using ~/.aws/credentials or the "AWS_SECRET_ACCESS_KEY" and "AWS_ACCESS_KEY_ID" environment variables.
    aws_access_key="<access key>",
    aws_secret_key="<secret key>",
    # Temporary credentials can be used with aws_session_token.
    # Read more at https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
    aws_session_token="<session_token>",
    # aws_region changes the aws region to which the request is made. By default, we read AWS_REGION,
    # and if that's not present, we default to us-east-1. Note that we do not read ~/.aws/config for the region.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="global.anthropic.claude-opus-4-6-v1",
    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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Реализация

Использование глобальных конечных точек (по умолчанию для Opus 4.6, Sonnet 4.5 и Sonnet 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-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

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

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

from anthropic import AnthropicBedrock

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

# Using US regional endpoint (CRIS)
message = client.messages.create(
    model="anthropic.claude-opus-4-6-v1",  # No global. prefix
    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: Документация по ценам