Amazon Bedrock 上的 Claude（旧版）

通过 Bedrock 调用 Claude 与直接在 Claude API 上调用 Claude 略有不同。本指南将引导您使用 Anthropic 的客户端 SDK 之一完成对 Bedrock 上 Claude 的 API 调用。

请注意，本指南假设您已经注册了 AWS 账户并配置了编程访问权限。



安装和配置 AWS CLI

1. 安装版本为 2.13.23 或更新的 AWS CLI
2. 使用 AWS configure 命令配置您的 AWS 凭证（请参阅配置 AWS CLI），或者在 AWS 控制面板中导航到"Command line or programmatic access"并按照弹出窗口中的说明查找您的凭证。
3. 验证您的凭证是否有效：

aws sts get-caller-identity



安装用于访问 Bedrock 的 SDK

Anthropic 的客户端 SDK 支持 Bedrock。您也可以直接使用 AWS SDK，例如 boto3。

pip install -U "anthropic[bedrock]"



访问 Bedrock



订阅 Anthropic 模型

前往 AWS Console > Bedrock > Model Access 并请求访问 Anthropic 模型。请注意，Anthropic 模型的可用性因区域而异。请参阅 AWS 文档获取最新信息。



API 模型 ID

生命周期术语（已弃用、已停用）在模型弃用中定义。合作伙伴运营平台上的生命周期日期由合作伙伴设定，可能与 Claude API 的时间表不同。有关 Amazon Bedrock 上任何模型的当前停用日期，请参阅 Amazon Bedrock 的模型生命周期页面。

有关区域与全球模型 ID 的更多信息，请参阅全球与区域端点部分。



列出可用模型

以下示例展示了如何打印通过 Bedrock 可用的所有 Claude 模型的列表：

import boto3

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

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



发出请求

以下示例展示了如何从 Bedrock 上的 Claude 生成文本：

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)

请参阅客户端 SDK 了解更多详细信息，以及 Bedrock 官方文档。



Bearer 令牌身份验证

您可以使用 bearer 令牌而不是 AWS 凭证来向 Bedrock 进行身份验证。这在企业环境中非常有用，因为团队需要访问 Bedrock 而无需管理 AWS 凭证、IAM 角色或账户级权限。

最简单的方法是设置 AWS_BEARER_TOKEN_BEDROCK 环境变量，每个 SDK 在从环境中解析凭证时都会自动检测到它。

要以编程方式提供令牌：

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    api_key="your-bearer-token",
    aws_region="us-west-2",
)

message = client.messages.create(
    model="us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)



活动日志记录

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 参数；请改用客户端回退模式）



Bedrock 上的 PDF 支持

Bedrock 通过 Converse API 和 InvokeModel API 均提供 PDF 支持。有关 PDF 处理能力和限制的详细信息，请参阅 Amazon Bedrock PDF 支持。

Converse API 用户的重要注意事项：

• 可视化 PDF 分析（图表、图像、布局）需要启用引用功能
• 如果不启用引用，则只能进行基本的文本提取
• 如需完全控制而不强制使用引用，请使用 InvokeModel API



上下文窗口

Claude Fable 5、Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6 和 Claude Sonnet 4.6 在 Amazon Bedrock 上具有 100 万令牌的上下文窗口。其他 Claude 模型，包括 Sonnet 4.5 和 Sonnet 4（已弃用），具有 20 万令牌的上下文窗口。

Bedrock 将请求负载限制为 20 MB。在发送大型文档或大量图像时，您可能会在达到令牌限制之前先达到此限制。



全球与区域端点

从 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 的模型 ID 已经包含 global. 前缀：

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

使用区域端点（CRIS）：

要使用区域端点，请将 global. 前缀替换为区域前缀，例如 us.：

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



其他资源

• Bedrock 定价： aws.amazon.com/bedrock/pricing
• AWS 定价文档： Bedrock 定价指南
• AWS 博客文章： 在 Amazon Bedrock 中推出 Claude Sonnet 4.5
• Anthropic 定价详情： 云平台定价