透過 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 Console > Bedrock > Model Access 並請求存取 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 3 anthropic.claude-3-opus-20240229-v1:0
Claude Sonnet 3 anthropic.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 存取您的內容。

功能支援

您可以在這裡找到 Bedrock 目前支援的所有功能。

Bedrock 上的 PDF 支援

PDF 支援可透過 Converse API 和 InvokeModel API 在 Amazon Bedrock 上使用。有關 PDF 處理功能和限制的詳細資訊,請參閱 PDF 支援文件

Converse API 使用者的重要考量:

  • 視覺 PDF 分析(圖表、圖像、版面配置)需要啟用引用
  • 沒有引用時,只能進行基本文字擷取
  • 如需完全控制而不強制引用,請使用 InvokeModel API

有關兩種文件處理模式及其限制的更多詳細資訊,請參閱 PDF 支援指南