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.

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



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

Следующие примеры показывают, как вывести список всех моделей 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:

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



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

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

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

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



Журналирование активности

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

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



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

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



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

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



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

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



Поддержка 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.:

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

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



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

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