Claude на Amazon Bedrock

Amazon Bedrock (устаревший)

На этой странице описана интеграция Amazon Bedrock, доступная в настоящее время (API InvokeModel и Converse с идентификаторами моделей с версией ARN и кодированием событий AWS). Исследовательский предпросмотр нового управляемого AWS предложения с Messages API по адресу /anthropic/v1/messages и потоковой передачей SSE задокументирован в разделе Claude в Amazon Bedrock (исследовательский предпросмотр).

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

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

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

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

Shell

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 Opus 4.7 доступен на AWS через Claude в Amazon Bedrock, в настоящее время в исследовательском предпросмотре. Он недоступен через стандартный каталог моделей 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.

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

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

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

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

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

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

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

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

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

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

Для всех поддерживаемых функций на Bedrock см. Обзор функций API.

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

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

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

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

Дополнительную информацию о двух режимах обработки документов и их ограничениях см. в руководстве по поддержке PDF.

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

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

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

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

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

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

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

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

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

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

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

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

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

Реализация

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

Идентификаторы моделей для Claude Sonnet 4.5 и 4 (устарел) уже включают префикс global.:

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

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

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

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

Цены AWS 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, на который выполняется запрос. По умолчанию мы читаем AWS_REGION,
    # и если его нет, мы используем us-east-1 по умолчанию. Обратите внимание, что мы не читаем ~/.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-east-1",
    }
);

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="anthropic.claude-opus-4-6-v1",  # Без префикса global.
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)