通過 Bedrock 呼叫 Claude 與使用 Anthropic 用戶端 SDK 呼叫 Claude 的方式略有不同。本指南將引導您完成通過 Python 或 TypeScript 向 Bedrock 上的 Claude 進行 API 呼叫的過程。 請注意，本指南假設您已經註冊了 AWS 帳戶並配置了程式化存取。

​
安裝並配置 AWS CLI

  1. 安裝版本為 2.13.23 或更新版本的 AWS CLI
  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 模型 ID

模型基礎 Bedrock 模型 IDglobaluseujpapac
Claude Sonnet 4.5anthropic.claude-sonnet-4-5-20250929-v1:0Copied!是是是是否
Claude Sonnet 4anthropic.claude-sonnet-4-20250514-v1:0Copied!是是是否是
Claude Sonnet 3.7 anthropic.claude-3-7-sonnet-20250219-v1:0Copied!否是是否是
Claude Opus 4.1anthropic.claude-opus-4-1-20250805-v1:0Copied!否是否否否
Claude Opus 4anthropic.claude-opus-4-20250514-v1:0Copied!否是否否否
Claude Opus 3 anthropic.claude-3-opus-20240229-v1:0Copied!否是否否否
Claude Haiku 4.5anthropic.claude-haiku-4-5-20251001-v1:0Copied!是是是否否
Claude Haiku 3.5anthropic.claude-3-5-haiku-20241022-v1:0Copied!否是否否否
Claude Haiku 3anthropic.claude-3-haiku-20240307-v1:0Copied!否是是否是
有關區域與全域模型 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(
    # 透過提供以下金鑰進行驗證，或使用預設的 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="global.anthropic.claude-sonnet-4-5-20250929-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 支援指南。

​
100 萬個 Token 上下文視窗

Claude Sonnet 4 和 4.5 在 Amazon Bedrock 上支援 100 萬個 Token 上下文視窗。
100 萬個 Token 上下文視窗目前處於測試版。若要使用擴展上下文視窗，請在您的 Bedrock API 請求中包含 context-1m-2025-08-07 測試版標頭。

​
全域與區域端點

從 Claude Sonnet 4.5 和所有未來模型開始，Amazon Bedrock 提供兩種端點類型：
  • 全域端點：動態路由以獲得最大可用性
  • 區域端點：保證透過特定地理區域的資料路由
區域端點包括相對於全域端點的 10% 定價溢價。
這僅適用於 Claude Sonnet 4.5 和未來模型。較舊的模型（Claude Sonnet 4、Opus 4 及更早版本）保持其現有的定價結構。

​
何時使用各選項

全域端點（推薦）：
  • 提供最大可用性和正常運行時間
  • 動態將請求路由到具有可用容量的區域
  • 無定價溢價
  • 最適合資料駐留靈活的應用程式
區域端點 (CRIS)：
  • 透過特定地理區域路由流量
  • 資料駐留和合規性要求所需
  • 適用於美國、歐盟、日本和澳洲
  • 10% 定價溢價反映了專用區域容量的基礎設施成本

​
實施

使用全域端點（Sonnet 4.5 和 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-sonnet-4-5-20250929-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")

# 使用美國區域端點 (CRIS)
message = client.messages.create(
    model="anthropic.claude-sonnet-4-5-20250929-v1:0",  # 沒有 global. 前綴
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)

​
其他資源