第三方平台上的 Claude

Amazon Bedrock 上的 Claude

Anthropic 的 Claude 模型现已通过 Amazon Bedrock 正式上线。

通过 Bedrock 调用 Claude 与使用 Anthropic 客户端 SDK 调用 Claude 略有不同。本指南将引导您完成在 Python 或 TypeScript 中通过 Bedrock 对 Claude 进行 API 调用的过程。

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

安装和配置 AWS CLI

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

Shell

aws sts get-caller-identity

安装用于访问 Bedrock 的 SDK

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

pip install -U "anthropic[bedrock]"

访问 Bedrock

订阅 Anthropic 模型

前往 AWS 控制台 > Bedrock > 模型访问并请求访问 Anthropic 模型。请注意，Anthropic 模型的可用性因区域而异。有关最新信息，请参阅 AWS 文档。

API 模型 ID

模型	基础 Bedrock 模型 ID	`global`	`us`	`eu`	`jp`	`apac`
Claude Opus 4.6	anthropic.claude-opus-4-6-v1:0	Yes	Yes	Yes	Yes	Yes
Claude Sonnet 4.5	anthropic.claude-sonnet-4-5-20250929-v1:0	Yes	Yes	Yes	Yes	No
Claude Sonnet 4	anthropic.claude-sonnet-4-20250514-v1:0	Yes	Yes	Yes	No	Yes
Claude Sonnet 3.7 ⚠️	anthropic.claude-3-7-sonnet-20250219-v1:0	No	Yes	Yes	No	Yes
Claude Opus 4.5	anthropic.claude-opus-4-5-20251101-v1:0	Yes	Yes	Yes	No	No
Claude Opus 4.1	anthropic.claude-opus-4-1-20250805-v1:0	No	Yes	No	No	No
Claude Opus 4	anthropic.claude-opus-4-20250514-v1:0	No	Yes	No	No	No
Claude Haiku 4.5	anthropic.claude-haiku-4-5-20251001-v1:0	Yes	Yes	Yes	No	No
Claude Haiku 3.5 ⚠️	anthropic.claude-3-5-haiku-20241022-v1:0	No	Yes	No	No	No
Claude Haiku 3	anthropic.claude-3-haiku-20240307-v1:0	No	Yes	Yes	No	Yes

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

列出可用模型

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

aws bedrock list-foundation-models --region=us-west-2 --by-provider anthropic --query "modelSummaries[*].modelId"

发送请求

以下示例展示了如何在 Bedrock 上通过 Claude 生成文本：

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Authenticate by either providing the keys below or use the default AWS credential providers, such as
    # using ~/.aws/credentials or the "AWS_SECRET_ACCESS_KEY" and "AWS_ACCESS_KEY_ID" environment variables.
    aws_access_key="<access key>",
    aws_secret_key="<secret key>",
    # Temporary credentials can be used with aws_session_token.
    # Read more at https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
    aws_session_token="<session_token>",
    # aws_region changes the aws region to which the request is made. By default, we read AWS_REGION,
    # and if that's not present, we default to us-east-1. Note that we do not read ~/.aws/config for the region.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="global.anthropic.claude-opus-4-6-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)
print(message.content)

有关更多详细信息，请参阅我们的客户端 SDK，以及官方 Bedrock 文档此处。

活动日志

Bedrock 提供了调用日志服务，允许客户记录与您的使用相关的提示和补全内容。

Anthropic 建议您至少以 30 天滚动的方式记录您的活动，以便了解您的活动并调查任何潜在的滥用行为。

开启此服务不会让 AWS 或 Anthropic 访问您的内容。

功能支持

您可以在此处找到 Bedrock 上当前支持的所有功能。

Bedrock 上的 PDF 支持

PDF 支持可通过 Converse API 和 InvokeModel API 在 Amazon Bedrock 上使用。有关 PDF 处理功能和限制的详细信息，请参阅 PDF 支持文档。

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

视觉 PDF 分析（图表、图像、布局）需要启用引用
如果不启用引用，则仅提供基本文本提取功能
如需完全控制且不强制引用，请使用 InvokeModel API

有关两种文档处理模式及其限制的更多详细信息，请参阅 PDF 支持指南。

1M token 上下文窗口

Claude Opus 4.6、Sonnet 4.5 和 Sonnet 4 在 Amazon Bedrock 上支持 1M token 上下文窗口。

1M token 上下文窗口目前处于测试阶段。要使用扩展上下文窗口，请在您的 Bedrock API 请求中包含 context-1m-2025-08-07 beta 头。

全球与区域端点

从 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 的模型 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:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)

使用区域端点（CRIS）：

要使用区域端点，请从模型 ID 中移除 global. 前缀：

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

# Using US regional endpoint (CRIS)
message = client.messages.create(
    model="anthropic.claude-opus-4-6-v1:0",  # No global. prefix
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)

其他资源

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

Was this page helpful?

第三方平台上的 Claude

Amazon Bedrock 上的 Claude

Anthropic 的 Claude 模型现已通过 Amazon Bedrock 正式上线。

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

安装和配置 AWS CLI

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

Shell

aws sts get-caller-identity

安装用于访问 Bedrock 的 SDK

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

pip install -U "anthropic[bedrock]"

访问 Bedrock

订阅 Anthropic 模型

前往 AWS 控制台 > Bedrock > 模型访问并请求访问 Anthropic 模型。请注意，Anthropic 模型的可用性因区域而异。有关最新信息，请参阅 AWS 文档。

API 模型 ID

模型	基础 Bedrock 模型 ID	`global`	`us`	`eu`	`jp`	`apac`
Claude Opus 4.6	anthropic.claude-opus-4-6-v1:0	Yes	Yes	Yes	Yes	Yes
Claude Sonnet 4.5	anthropic.claude-sonnet-4-5-20250929-v1:0	Yes	Yes	Yes	Yes	No
Claude Sonnet 4	anthropic.claude-sonnet-4-20250514-v1:0	Yes	Yes	Yes	No	Yes
Claude Sonnet 3.7 ⚠️	anthropic.claude-3-7-sonnet-20250219-v1:0	No	Yes	Yes	No	Yes
Claude Opus 4.5	anthropic.claude-opus-4-5-20251101-v1:0	Yes	Yes	Yes	No	No
Claude Opus 4.1	anthropic.claude-opus-4-1-20250805-v1:0	No	Yes	No	No	No
Claude Opus 4	anthropic.claude-opus-4-20250514-v1:0	No	Yes	No	No	No
Claude Haiku 4.5	anthropic.claude-haiku-4-5-20251001-v1:0	Yes	Yes	Yes	No	No
Claude Haiku 3.5 ⚠️	anthropic.claude-3-5-haiku-20241022-v1:0	No	Yes	No	No	No
Claude Haiku 3	anthropic.claude-3-haiku-20240307-v1:0	No	Yes	Yes	No	Yes

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

列出可用模型

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

aws bedrock list-foundation-models --region=us-west-2 --by-provider anthropic --query "modelSummaries[*].modelId"

发送请求

以下示例展示了如何在 Bedrock 上通过 Claude 生成文本：

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Authenticate by either providing the keys below or use the default AWS credential providers, such as
    # using ~/.aws/credentials or the "AWS_SECRET_ACCESS_KEY" and "AWS_ACCESS_KEY_ID" environment variables.
    aws_access_key="<access key>",
    aws_secret_key="<secret key>",
    # Temporary credentials can be used with aws_session_token.
    # Read more at https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
    aws_session_token="<session_token>",
    # aws_region changes the aws region to which the request is made. By default, we read AWS_REGION,
    # and if that's not present, we default to us-east-1. Note that we do not read ~/.aws/config for the region.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="global.anthropic.claude-opus-4-6-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)
print(message.content)

有关更多详细信息，请参阅我们的客户端 SDK，以及官方 Bedrock 文档此处。

活动日志

Bedrock 提供了调用日志服务，允许客户记录与您的使用相关的提示和补全内容。

Anthropic 建议您至少以 30 天滚动的方式记录您的活动，以便了解您的活动并调查任何潜在的滥用行为。

开启此服务不会让 AWS 或 Anthropic 访问您的内容。

功能支持

您可以在此处找到 Bedrock 上当前支持的所有功能。

Bedrock 上的 PDF 支持

PDF 支持可通过 Converse API 和 InvokeModel API 在 Amazon Bedrock 上使用。有关 PDF 处理功能和限制的详细信息，请参阅 PDF 支持文档。

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

视觉 PDF 分析（图表、图像、布局）需要启用引用
如果不启用引用，则仅提供基本文本提取功能
如需完全控制且不强制引用，请使用 InvokeModel API

有关两种文档处理模式及其限制的更多详细信息，请参阅 PDF 支持指南。

1M token 上下文窗口

Claude Opus 4.6、Sonnet 4.5 和 Sonnet 4 在 Amazon Bedrock 上支持 1M token 上下文窗口。

1M token 上下文窗口目前处于测试阶段。要使用扩展上下文窗口，请在您的 Bedrock API 请求中包含 context-1m-2025-08-07 beta 头。

全球与区域端点

从 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 的模型 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:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)

使用区域端点（CRIS）：

要使用区域端点，请从模型 ID 中移除 global. 前缀：

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

# Using US regional endpoint (CRIS)
message = client.messages.create(
    model="anthropic.claude-opus-4-6-v1:0",  # No global. prefix
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)

其他资源

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

Was this page helpful?