Loading...
  • 建構
  • 管理
  • 模型與定價
  • 客戶端 SDK
  • API 參考
Search...
⌘K
Log in
Amazon Bedrock(舊版)
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
管理/第三方平台

Amazon Bedrock 上的 Claude

Anthropic 的 Claude 模型現已通過 Amazon Bedrock 正式推出。

本頁涵蓋目前可用的 Amazon Bedrock 整合(使用 ARN 版本化模型識別符和 AWS 事件流編碼的 InvokeModel 和 Converse API)。新的 AWS 託管產品的研究預覽版本,具有 /anthropic/v1/messages 的 Messages API 和 SSE 串流功能,已記錄在 Amazon Bedrock 中的 Claude(研究預覽版)。

通過 Bedrock 呼叫 Claude 與使用 Anthropic 的用戶端 SDK 呼叫 Claude 的方式略有不同。本指南將引導您使用 Anthropic 的 用戶端 SDK 之一完成對 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。

存取 Bedrock

訂閱 Anthropic 模型

前往 AWS 主控台 > Bedrock > 模型存取並請求存取 Anthropic 模型。請注意,Anthropic 模型的可用性因地區而異。請參閱 AWS 文件以取得最新資訊。

API 模型 ID

Claude Opus 4.7 可通過 Amazon Bedrock 中的 Claude 在 AWS 上使用,目前處於研究預覽版本。它不可通過本頁記錄的標準 Bedrock 模型目錄使用。

模型基礎 Bedrock 模型 IDglobaluseujpapac
Claude Opus 4.6anthropic.claude-opus-4-6-v1是是是是是
Claude Sonnet 4.6anthropic.claude-sonnet-4-6是是是是否
Claude Sonnet 4.5anthropic.claude-sonnet-4-5-20250929-v1:0是是是是否
Claude Sonnet 4 ⚠️anthropic.claude-sonnet-4-20250514-v1:0是是是否是
Claude Sonnet 3.7 ⚠️anthropic.claude-3-7-sonnet-20250219-v1:0否是是否是
Claude Opus 4.5anthropic.claude-opus-4-5-20251101-v1:0是是是否否
Claude Opus 4.1anthropic.claude-opus-4-1-20250805-v1:0否是否否否
Claude Opus 4 ⚠️anthropic.claude-opus-4-20250514-v1:0否是否否否
Claude Haiku 4.5anthropic.claude-haiku-4-5-20251001-v1:0是是是否否
Claude Haiku 3.5 ⚠️anthropic.claude-3-5-haiku-20241022-v1:0否是否否否
Claude Haiku 3 ⚠️anthropic.claude-3-haiku-20240307-v1:0否是是否是

有關區域與全球模型 ID 的更多資訊,請參閱下方的 全球與區域端點 部分。

列出可用模型

以下範例顯示如何列印所有通過 Bedrock 可用的 Claude 模型:

import boto3

bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")

for summary in response["modelSummaries"]:
    print(summary["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-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)
print(message.content)

請參閱 用戶端 SDK 以取得更多詳細資訊,以及 官方 Bedrock 文件。

Bearer 令牌驗證

您可以使用 Bearer 令牌而不是 AWS 認證來驗證 Bedrock。這在企業環境中很有用,其中團隊需要存取 Bedrock,而無需管理 AWS 認證、IAM 角色或帳戶級別的權限。

Bearer 令牌驗證在 C#、Go 和 Java SDK 中受支援。PHP、Python、TypeScript 和 Ruby SDK 僅使用 AWS SigV4 簽署。

最簡單的方法是設定 AWS_BEARER_TOKEN_BEDROCK 環境變數,該變數由 fromEnv() 認證解析自動偵測。

若要以程式化方式提供令牌:

using Anthropic.Bedrock;
using Anthropic.Models.Messages;

var client = new AnthropicBedrockClient(
    new AnthropicBedrockApiTokenCredentials
    {
        BearerToken = "your-bearer-token",
        Region = "us-east-1",
    }
);

var response = await client.Messages.Create(new MessageCreateParams
{
    Model = "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    MaxTokens = 1024,
    Messages = [new() { Role = Role.User, Content = "Hello!" }],
});

活動日誌

Bedrock 提供 呼叫日誌服務,允許客戶記錄與您的使用相關的提示和完成。

Anthropic 建議您至少在 30 天滾動基礎上記錄您的活動,以便了解您的活動並調查任何潛在的濫用。

啟用此服務不會給 AWS 或 Anthropic 任何存取您的內容的權限。

功能支援

有關 Bedrock 上目前支援的所有功能,請參閱 API 功能概述。

Bedrock 上的 PDF 支援

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

Converse API 使用者的重要考慮事項:

  • 視覺 PDF 分析(圖表、影像、版面配置)需要啟用引用
  • 沒有引用,只有基本文字提取可用
  • 為了完全控制而不強制引用,請使用 InvokeModel API

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

上下文視窗

Claude Opus 4.6 和 Claude Sonnet 4.6 在 Amazon Bedrock 上有 100 萬令牌上下文視窗。其他 Claude 模型,包括 Sonnet 4.5 和 Sonnet 4(已棄用),有 200k 令牌上下文視窗。

Amazon Bedrock 將請求有效負載限制為 20 MB。發送大型文件或許多影像時,您可能會在達到令牌限制之前達到此限制。

全球與區域端點

從 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",
    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-opus-4-6-v1",  # 無 global. 前綴
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

Claude Mythos 預覽版 是一個研究預覽版模型,可供 Amazon Bedrock 上的受邀客戶使用。有關更多資訊,請參閱 Project Glasswing。

其他資源

  • AWS Bedrock 定價: aws.amazon.com/bedrock/pricing
  • AWS 定價文件: Bedrock 定價指南
  • AWS 部落格文章: 在 Amazon Bedrock 中介紹 Claude Sonnet 4.5
  • Anthropic 定價詳細資訊: 定價文件

Was this page helpful?

  • 安裝和配置 AWS CLI
  • 安裝用於存取 Bedrock 的 SDK
  • 存取 Bedrock
  • 訂閱 Anthropic 模型
  • Bearer 令牌驗證
  • Bedrock 上的 PDF 支援