Claude на Amazon Bedrock (устаревшая версия)

На этой странице описана устаревшая интеграция с Amazon Bedrock: API InvokeModel и Converse с идентификаторами моделей на основе ARN с версионированием и кодированием потока событий AWS. Для моделей, доступных через эндпоинт Bedrock на базе Messages API, см. Claude в Amazon Bedrock, где используется Messages API по адресу /anthropic/v1/messages с потоковой передачей SSE. Для альтернативы, управляемой Anthropic, с биллингом через AWS Marketplace и, как правило, доступом к функциям в день их выпуска, см. Claude Platform на AWS. Существующие пользователи Bedrock могут воспользоваться руководством по миграции.

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

Обратите внимание, что это руководство предполагает, что вы уже зарегистрировали учётную запись AWS и настроили программный доступ.

Установка и настройка AWS CLI

Установите версию AWS CLI не ниже 2.13.23
Настройте ваши учётные данные AWS с помощью команды AWS configure (см. Настройка AWS CLI) или найдите ваши учётные данные, перейдя в раздел «Command line or programmatic access» в панели управления AWS и следуя инструкциям во всплывающем модальном окне.
Убедитесь, что ваши учётные данные работают:

AWS CLI

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 Fable 5, Claude Opus 4.8 и Claude Opus 4.7 доступны через InvokeModel на bedrock-runtime. Эти запросы обслуживаются той же инфраструктурой, что и эндпоинт Claude в Amazon Bedrock. Для нативной формы запроса Messages API и полного паритета функций используйте ту страницу. Claude Fable 5, Claude Opus 4.8 и Claude Opus 4.7 не включены в таблицу моделей на этой странице, поскольку у них нет идентификаторов моделей на основе ARN с версионированием.

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

Модель	Базовый идентификатор модели Bedrock	`global`	`us`	`eu`	`jp`	`apac`
Claude Opus 4.6	anthropic.claude-opus-4-6-v1	Да	Да	Да	Да	Да
Claude Sonnet 4.6	anthropic.claude-sonnet-4-6	Да	Да	Да	Да	Нет
Claude Sonnet 4.5	anthropic.claude-sonnet-4-5-20250929-v1:0	Да

Дополнительную информацию о региональных и глобальных идентификаторах моделей см. в разделе Глобальные и региональные эндпоинты.

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

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

Выполнение запросов

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

Подробнее см. в разделе клиентские SDK, а также в официальной документации Bedrock.

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

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

Аутентификация с помощью bearer-токена поддерживается в SDK для C#, Go и Java. SDK для PHP, Python, TypeScript и Ruby используют только подпись AWS SigV4.

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

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

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

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

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

Включение этого сервиса не даёт AWS или Anthropic никакого доступа к вашему контенту.

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

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

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

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

Источники входных данных (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 4.8, Claude Opus 4.7, Claude Opus 4.6 и Claude Sonnet 4.6 имеют контекстное окно в 1 млн токенов на Amazon Bedrock. Другие модели Claude, включая Sonnet 4.5 и Sonnet 4 (устаревшая), имеют контекстное окно в 200 тыс. токенов.

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

Глобальные и региональные эндпоинты

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

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

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

Это относится только к Claude Sonnet 4.5 и последующим моделям. Более старые модели (Claude Sonnet 4 (устаревшая), Opus 4 (устаревшая) и более ранние) сохраняют свои существующие структуры ценообразования.

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

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

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

Региональные эндпоинты (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.:

Claude Mythos Preview — это исследовательская предварительная версия модели, доступная приглашённым клиентам на Amazon Bedrock. Дополнительную информацию см. в разделе Project Glasswing.

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

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

import boto3

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

for summary in response["modelSummaries"]:
    print(summary["modelId"])

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)

using Anthropic.Bedrock;
using Anthropic.Models.Messages;

var client = new AnthropicBedrockClient(
    new AnthropicBedrockApiTokenCredentials
    {
        BearerToken = "your-bearer-token",
        Region = "us-west-2",
    }
);

var response = await client.Messages.Create(new MessageCreateParams
{
    Model = "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    MaxTokens = 1024,
    Messages = [new() { Role = Role.User, Content = "Hello!" }],
});

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"}],
)

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"}],
)