Это руководство проведет вас через процесс настройки и выполнения вызовов API к Claude в Amazon Bedrock. Claude в Amazon Bedrock работает на управляемой AWS инфраструктуре с нулевым доступом оператора (сотрудники Anthropic не имеют доступа к инфраструктуре вывода), позволяя вам создавать чувствительные приложения полностью внутри границы безопасности AWS, используя ту же форму Messages API, которую вы используете с первоклассным API Anthropic.
На этой странице рассматривается исследовательский предпросмотр нового предложения Claude в Amazon Bedrock, которое предоставляет Messages API по адресу /anthropic/v1/messages. Для существующей интеграции Bedrock (APIs InvokeModel и Converse с идентификаторами моделей с версией ARN и кодированием AWS event-stream) см. Claude на Amazon Bedrock.
Конечная точка Claude в Amazon Bedrock находится в исследовательском предпросмотре, доступна в регионе US East (N. Virginia) us-east-1. Свяжитесь с вашим менеджером аккаунта Anthropic, чтобы запросить доступ.
Перед началом убедитесь, что у вас есть:
us-east-1. Исследовательский предпросмотр требует выделенного аккаунта для изоляции. Ваш менеджер аккаунта Anthropic отправит ваш ID аккаунта команде Bedrock Marketplace для добавления в список разрешений (обычно обрабатывается в течение 24 часов).Claude в Amazon Bedrock поддерживает три пути аутентификации. Выберите тот, который лучше всего соответствует вашим требованиям безопасности.
Используйте роль сервиса Bedrock с управляемыми AWS ключами для наиболее безопасного долгосрочного доступа:
Администратор: подготовьте роль сервиса
Администратор AWS подготавливает роль сервиса Bedrock и предоставляет разработчикам разрешение iam:PassRole на ARN роли сервиса.
Разработчик: передайте роль
При вызове API Bedrock принимает роль сервиса от вашего имени. См. документацию Amazon Bedrock для получения информации о том, как связать роль с вашими запросами.
Для доступа с федерацией идентификации с максимальной сессией в 12 часов:
Администратор: настройте роль IAM
Создайте роль IAM, ограниченную вашими моделями Claude. Политика доверия указывает вашего поставщика идентификации (SAML, OIDC или AWS Identity Center). Политика разрешений предоставляет bedrock-mantle:CreateInference только на разрешенные ARN моделей.
Разработчик: аутентифицируйтесь и предположите
Аутентифицируйтесь через вашего корпоративного поставщика идентификации, затем примите роль IAM. AWS STS выдает временные учетные данные, которые SDK или CLI использует для подписания запросов.
Для краткосрочного доступа без ролей IAM (максимум 12 часов, наименее предпочтительно):
Администратор: ограничьте типы токенов
Заблокируйте долгосрочные ключи, прикрепив политику, которая отрицает bedrock:CallWithBearerToken, если условие bedrock:BearerTokenType не соответствует краткосрочному токену.
Разработчик: создайте токен
Используйте CLI aws-bedrock-token-generator для создания токена bearer. Передайте его в заголовке x-api-key в каждом запросе.
Клиентские SDK Anthropic поддерживают Claude в Amazon Bedrock через пакет или модуль, специфичный для Bedrock.
Конечная точка следует шаблону https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. В отличие от интеграции на основе InvokeModel, эта конечная точка использует стандартную потоковую передачу SSE и ту же форму тела запроса, что и первоклассный API Anthropic.
SDK разрешает учетные данные и регион, используя стандартный приоритет AWS: аргументы конструктора, затем переменные окружения (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), затем файл конфигурации AWS и цепочка учетных данных (SSO, предполагаемые роли, роль задачи ECS, IMDS).
Вы также можете использовать стандартный клиент Anthropic: установите base_url на https://bedrock-mantle.{region}.api.aws/anthropic и передайте ваш токен bearer как api_key. Этот путь поддерживает только аутентификацию с токеном bearer. Подписание SigV4 требует выделенного клиента.
Идентификаторы моделей в Claude в Amazon Bedrock имеют префикс поставщика anthropic.. Возможности и поведение моделей задокументированы на странице Обзор моделей.
| Модель | ID модели |
|---|---|
| Claude Opus 4.7 | anthropic.claude-opus-4-7 |
| Claude Mythos Preview | anthropic.claude-mythos-preview |
| Claude Haiku 4.5 | anthropic.claude-haiku-4-5 |
Claude в Amazon Bedrock поддерживает функции, которые работают внутри модели. Функции, которые требуют инфраструктуры, управляемой Anthropic, недоступны.
Поддерживается:
/v1/messages)Не поддерживается:
/v1/usersИсследовательский предпросмотр доступен только в us-east-1 (IAD).
Квота по умолчанию составляет 2 миллиона входных токенов в минуту (TPM). Вы можете запросить до 4 миллионов входных TPM без дополнительного одобрения Anthropic. AWS применяет ограничения на количество запросов в минуту (RPM) на стороне Bedrock; свяжитесь с поддержкой AWS для корректировки RPM.
Обработка данных для этого предложения регулируется Amazon Bedrock. Для получения подробной информации см. Защита данных в Amazon Bedrock.
Доступно нулевое хранение данных (ZDR). Чтобы включить ZDR для вашего аккаунта, свяжитесь с поддержкой AWS.
Claude в Amazon Bedrock отправляет логи как в CloudWatch, так и в CloudTrail. Anthropic рекомендует сохранять логи активности по крайней мере на основе 30-дневного скользящего окна, чтобы понять закономерности использования и исследовать потенциальные проблемы.
Для поддержки исследовательского предпросмотра свяжитесь с [email protected]. Включите ваш ID аккаунта AWS и request-id из любых неудачных ответов API.
Claude Mythos Preview — это исследовательская предпросмотровая модель, доступная приглашенным клиентам на Amazon Bedrock. Для получения дополнительной информации см. Project Glasswing.
Was this page helpful?