Claude в Amazon Bedrock (Opus 4.7 и более поздние версии)

Это руководство проведет вас через настройку и выполнение вызовов API к Claude в Amazon Bedrock. Claude в Amazon Bedrock работает на инфраструктуре, управляемой AWS, с нулевым доступом оператора (персонал Anthropic не имеет доступа к инфраструктуре инференса), что позволяет вам создавать чувствительные приложения полностью внутри границы безопасности AWS, используя ту же форму Messages API, которую вы используете с собственным API Anthropic.



Доступ

Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5, Claude Opus 4.7 и Claude Haiku 4.5 открыты для всех клиентов Amazon Bedrock. Claude Mythos Preview требует приглашения; см. Project Glasswing. Информацию о доступности по регионам см. в разделе Регионы.



Предварительные требования

Прежде чем начать, убедитесь, что у вас есть:

• Учетная запись AWS с включенным доступом к моделям Amazon Bedrock для моделей Claude, которые вы собираетесь использовать.
• Установленный и настроенный AWS CLI (необязательно, для управления учетными данными).

Claude Mythos Preview дополнительно требует выделенной учетной записи AWS, которая была внесена в список разрешенных командой Bedrock Marketplace. Ваш менеджер по работе с клиентами Anthropic может отправить идентификатор вашей учетной записи для внесения в список разрешенных (обычно обрабатывается в течение 24 часов), и AWS отправит приветственное письмо после завершения.



Аутентификация

Claude в Amazon Bedrock поддерживает три пути аутентификации. Выберите тот, который лучше всего соответствует вашим требованиям безопасности.



Сервисная роль Bedrock (рекомендуется)

Используйте сервисную роль Bedrock с ключами, управляемыми AWS, для наиболее безопасного долгосрочного доступа:



Принимаемые роли IAM

Для доступа с федерацией удостоверений с максимальной сессией 12 часов:



Токены bearer

Для краткосрочного доступа без ролей IAM (максимум 12 часов, наименее предпочтительный вариант):



Установка SDK

Клиентские SDK Anthropic поддерживают Claude в Amazon Bedrock через специальный пакет или модуль для Bedrock.

pip install -U "anthropic[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).

curl https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \
  --aws-sigv4 "aws:amz:us-east-1:bedrock-mantle" \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "anthropic.claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude"}
    ]
  }'



Поддерживаемые модели

Идентификаторы моделей в Claude в Amazon Bedrock содержат префикс поставщика anthropic.. Возможности и поведение моделей задокументированы на странице Обзор моделей.



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

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



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

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



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

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



Регионы

Claude в Amazon Bedrock доступен в следующих регионах AWS. Amazon Bedrock предлагает два типа конечных точек:

• Глобальная: динамическая маршрутизация по всем доступным регионам для максимальной доступности. Без надбавки к цене.
• Региональная: конечная точка разрешается в единственный указанный вами регион AWS для требований к резидентности данных. Региональные конечные точки имеют надбавку к цене в 10% по сравнению с глобальными конечными точками. Для маршрутизации по нескольким регионам в пределах географической зоны используйте профиль инференса (US, EU, JP или AU). Регионы, отмеченные в таблице как Только внутри региона, поддерживают прямую маршрутизацию в один регион без профиля инференса.

Глобальная конечная точка доступна для Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 и Claude Haiku 4.5. Claude Mythos Preview доступен только регионально в us-east-1.



Квоты

Квота по умолчанию составляет 2 миллиона входных токенов в минуту (TPM). Вы можете запросить до 4 миллионов входных TPM без дополнительного одобрения Anthropic. AWS применяет ограничения на количество запросов в минуту (RPM) на стороне Bedrock; обратитесь в поддержку AWS для корректировки RPM.



Хранение данных

Обработка данных для этого предложения регулируется Amazon Bedrock. Подробности см. в разделе Защита данных в Amazon Bedrock.



Мониторинг и логирование

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



Поддержка

Для получения поддержки обращайтесь по адресу [email protected]. Укажите идентификатор вашей учетной записи AWS и request-id из любых неудачных ответов API.