Amazon Bedrock 上的 Claude（Opus 4.6 及更早版本）

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

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



安装和配置 AWS CLI

1. 安装 AWS CLI，版本需为 2.13.23 或更新。
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 的模型生命周期页面。

AWS 通过跨区域推理而非按需吞吐量提供较新的 Claude 模型。对于这些模型，传递基础模型 ID 的请求会失败并返回类似以下的 HTTP 400 错误：

Invocation of model ID anthropic.claude-sonnet-4-5-20250929-v1:0 with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.

要调用这些模型，请传递推理配置文件（inference profile）而不是基础模型 ID。推理配置文件 ID 是在基础模型 ID 前加上下表中标记为"Yes"的列所对应的前缀，例如 us.anthropic.claude-sonnet-4-5-20250929-v1:0。您也可以传递完整的推理配置文件 ARN，格式为 arn:aws:bedrock:{region}:{account-id}:inference-profile/{inference-profile-id}。有关 AWS 提供的可用推理配置文件的权威列表，请参阅推理配置文件支持的区域和模型。有关前缀如何影响路由和定价，请参阅全球端点与区域端点部分。



列出可用模型

以下示例展示了如何打印通过 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 生成文本：

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



Bearer 令牌身份验证

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

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

要以编程方式提供令牌：



活动日志记录

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 5、Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6、Claude Sonnet 5 和 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. 前缀：

使用区域端点（CRIS）：

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



其他资源

• Bedrock 定价： Amazon Bedrock 定价页面
• AWS 定价文档： Bedrock 定价指南
• AWS 博客文章： 在 Amazon Bedrock 中推出 Claude Sonnet 4.5
• Anthropic 定价详情： 云平台定价