透過 Bedrock 呼叫 Claude 與使用 Anthropic 的客戶端 SDK 呼叫 Claude 略有不同。本指南將引導您完成在 Python 或 TypeScript 中透過 Bedrock 對 Claude 進行 API 呼叫的過程。
請注意,本指南假設您已經註冊了 AWS 帳戶並配置了程式化存取。
2.13.23 或更新版本aws sts get-caller-identityAnthropic 的客戶端 SDK 支援 Bedrock。您也可以直接使用 AWS SDK,例如 boto3。
pip install -U "anthropic[bedrock]"前往 AWS 主控台 > Bedrock > 模型存取並請求存取 Anthropic 模型。請注意,Anthropic 模型的可用性因區域而異。請參閱 AWS 文件以獲取最新資訊。
| 模型 | 基礎 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 上支援的所有功能。
PDF 支援可透過 Converse API 和 InvokeModel API 在 Amazon Bedrock 上使用。有關 PDF 處理功能和限制的詳細資訊,請參閱 PDF 支援文件。
Converse API 使用者的重要注意事項:
有關兩種文件處理模式及其限制的更多詳細資訊,請參閱 PDF 支援指南。
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):
使用全域端點(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"}]
)Was this page helpful?