Claude в Amazon Bedrock (Opus 4.6 и более ранние версии)

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

Обратите внимание, что это руководство предполагает, что вы уже зарегистрировали учётную запись 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

Термины жизненного цикла (Deprecated — устаревшая, Retired — выведена из эксплуатации) определены в разделе Устаревание моделей. Даты жизненного цикла на платформах, управляемых партнёрами, устанавливаются партнёром и могут отличаться от расписания Claude API. Актуальную дату вывода из эксплуатации любой модели в Amazon Bedrock см. на странице жизненного цикла моделей Amazon Bedrock.

AWS предлагает более новые модели Claude через межрегиональный вывод (cross-region inference), а не через пропускную способность по требованию. Для этих моделей запрос, передающий базовый идентификатор модели, завершается ошибкой HTTP 400, подобной следующей:

Invocation of model ID anthropic.claude-sonnet-4-5-20250929-v1:0 with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.

Чтобы вызвать эти модели, передайте профиль вывода (inference profile) вместо базового идентификатора модели. Идентификатор профиля вывода — это базовый идентификатор модели с префиксом из столбца, отмеченного «Yes» в следующей таблице, например us.anthropic.claude-sonnet-4-5-20250929-v1:0. Вы также можете передать полный ARN профиля вывода в формате arn:aws:bedrock:{region}:{account-id}:inference-profile/{inference-profile-id}. Авторитетный список доступных профилей вывода от AWS см. в разделе Supported Regions and models for inference profiles. О том, как префиксы влияют на маршрутизацию и ценообразование, см. в разделе Глобальные и региональные конечные точки.



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

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

import boto3

bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")

for summary in response["modelSummaries"]:
    print(summary["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, в который отправляется запрос. По умолчанию SDK читает AWS_REGION,
    # а если она отсутствует, использует us-east-1. Обратите внимание: SDK не читает регион из ~/.aws/config.
    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.



Аутентификация с помощью bearer-токена

Вы можете аутентифицироваться в Bedrock с помощью bearer-токенов вместо учётных данных AWS. Это полезно в корпоративных средах, где командам нужен доступ к Bedrock без управления учётными данными AWS, ролями IAM или разрешениями на уровне учётной записи.

Самый простой подход — установить переменную окружения AWS_BEARER_TOKEN_BEDROCK, которую каждый SDK автоматически обнаруживает при разрешении учётных данных из окружения.

Чтобы предоставить токен программно:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    api_key="your-bearer-token",
    aws_region="us-west-2",
)

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



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

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

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



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

Полный список функций с указанием доступности в Amazon Bedrock см. в разделе Обзор функций.



Основные поддерживаемые функции

• Messages API
• Кэширование подсказок
• Мышление
• Использование инструментов, включая инструмент Bash, инструмент Computer use, инструмент Memory и инструмент Text editor
• Цитирование
• Структурированные выводы



Неподдерживаемые функции

• Источники ввода (URL-источники для изображений и документов, Files API)
• Серверные инструменты (выполнение кода, веб-поиск, веб-загрузка, advisor)
• Агентная инфраструктура (Agent Skills, коннектор MCP, программный вызов инструментов)
• Конечные точки API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Серверный резервный вариант (параметр fallbacks; вместо этого используйте шаблон клиентского резервного варианта)
• Автоматическое кэширование подсказок (поле cache_control верхнего уровня; вместо этого используйте явные точки разрыва кэша)



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

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

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

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



Контекстное окно

Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 и Claude Sonnet 4.6 имеют контекстное окно в 1 млн токенов в Amazon Bedrock. Другие модели Claude, включая Sonnet 4.5 и Sonnet 4 (устаревшая), имеют контекстное окно в 200 тыс. токенов.

Bedrock ограничивает полезную нагрузку запроса 20 МБ. При отправке больших документов или множества изображений вы можете достичь этого лимита раньше, чем лимита токенов.



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

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

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

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



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

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

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

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

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



Реализация

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

Идентификаторы моделей для Claude Opus 4.6, Sonnet 4.6 и Sonnet 4.5 уже включают префикс 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. на региональный префикс, например us.:

from anthropic import AnthropicBedrock

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

# Использование регионального эндпоинта США (CRIS)
message = client.messages.create(
    model="us.anthropic.claude-opus-4-6-v1",  # Regional prefix
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)



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

• Цены Bedrock: страница цен Amazon Bedrock
• Документация AWS по ценам: руководство по ценам Bedrock
• Публикация в блоге AWS: Introducing Claude Sonnet 4.5 in Amazon Bedrock
• Подробности о ценах Anthropic: цены облачных платформ