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

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

安装和配置AWS CLI

  1. 安装AWS CLI版本,版本需为2.13.23或更新版本
  2. 使用AWS configure命令配置您的AWS凭证(参见配置AWS CLI),或通过在AWS控制面板中导航至”命令行或程序化访问”并按照弹出模态框中的指示找到您的凭证。
  3. 验证您的凭证是否正常工作:
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模型名称

模型Bedrock API模型名称
Claude Opus 4anthropic.claude-opus-4-20250514-v1:0
Claude Sonnet 4anthropic.claude-sonnet-4-20250514-v1:0
Claude Sonnet 3.7anthropic.claude-3-7-sonnet-20250219-v1:0
Claude Haiku 3.5anthropic.claude-3-5-haiku-20241022-v1:0
Claude Sonnet 3.5anthropic.claude-3-5-sonnet-20241022-v2:0
Claude Opus 3anthropic.claude-3-opus-20240229-v1:0
Claude Sonnet 3anthropic.claude-3-sonnet-20240229-v1:0
Claude Haiku 3anthropic.claude-3-haiku-20240307-v1:0

列出可用模型

以下示例展示了如何打印通过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(
    # 通过提供以下密钥进行身份验证,或使用默认的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="anthropic.claude-opus-4-20250514-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)
print(message.content)

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

活动日志记录

Bedrock提供了一个调用日志服务,允许客户记录与您的使用相关的提示和完成内容。

Anthropic建议您至少在30天滚动基础上记录您的活动,以了解您的活动并调查任何潜在的滥用。

开启此服务不会给AWS或Anthropic提供对您内容的任何访问权限。