Amazon Bedrock 上的 Claude（Opus 4.6 及更早版本）

透過 Bedrock 呼叫 Claude 與直接在 Claude API 上呼叫 Claude 的方式略有不同。本指南將引導您使用 Anthropic 的用戶端 SDK 之一，完成對 Bedrock 上 Claude 的 API 呼叫。

請注意，本指南假設您已經註冊了 AWS 帳戶並設定了程式化存取。



安裝並設定 AWS CLI

1. 安裝版本為 2.13.23 或更新版本的 AWS CLI。
2. 使用 AWS configure 命令設定您的 AWS 憑證（請參閱設定 AWS CLI），或在 AWS 儀表板中導覽至「Command line or programmatic access」並依照彈出視窗中的指示找到您的憑證。
3. 驗證您的憑證是否正常運作：

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 模型 ID

生命週期術語（已棄用、已停用）的定義請參閱模型棄用。合作夥伴營運平台上的生命週期日期由合作夥伴設定，可能與 Claude API 的時程不同。如需 Amazon Bedrock 上任何模型目前的停用日期，請參閱 Amazon Bedrock 的模型生命週期頁面。

AWS 透過跨區域推論而非隨需輸送量提供較新的 Claude 模型。對於這些模型，傳遞基礎模型 ID 的請求會失敗並出現如下的 HTTP 400 錯誤：

Invocation of model ID anthropic.claude-sonnet-4-5-20250929-v1:0 with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.

若要呼叫這些模型，請傳遞推論設定檔（inference profile）而非基礎模型 ID。推論設定檔 ID 是在基礎模型 ID 前加上下表中標記為「Yes」的欄位前綴，例如 us.anthropic.claude-sonnet-4-5-20250929-v1:0。您也可以傳遞完整的推論設定檔 ARN，格式為 arn:aws:bedrock:{region}:{account-id}:inference-profile/{inference-profile-id}。如需 AWS 官方提供的可用推論設定檔清單，請參閱推論設定檔支援的區域和模型。如需了解前綴如何影響路由和定價，請參閱全域與區域端點章節。



列出可用模型

以下範例展示如何列印透過 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 生成文字：

如需更多詳細資訊，請參閱用戶端 SDK 以及官方 Bedrock 文件。



Bearer token 驗證

您可以使用 bearer token 而非 AWS 憑證來向 Bedrock 進行驗證。這在企業環境中非常有用，因為團隊需要存取 Bedrock，但不需要管理 AWS 憑證、IAM 角色或帳戶層級的權限。

最簡單的方法是設定 AWS_BEARER_TOKEN_BEDROCK 環境變數，每個 SDK 在從環境解析憑證時都會自動偵測該變數。

若要以程式化方式提供 token：



活動記錄

Bedrock 提供呼叫記錄服務，讓您可以記錄與您的使用相關的提示和完成內容。

Anthropic 建議您至少以 30 天的滾動週期記錄您的活動，以了解您的活動並調查任何潛在的濫用行為。



功能支援

如需包含 Amazon Bedrock 可用性的完整功能清單，請參閱功能總覽。



支援的功能重點

• Messages API
• 提示快取
• 思考
• 工具使用，包括 Bash 工具、電腦使用工具、記憶工具和文字編輯器工具
• 引用
• 結構化輸出



不支援的功能

• 輸入來源（圖片和文件的 URL 來源、Files API）
• 伺服器端工具（程式碼執行、網頁搜尋、網頁擷取、advisor）
• 代理基礎設施（Agent Skills、MCP 連接器、程式化工具呼叫）
• API 端點（Message Batches、Models、Admin、Compliance、Usage and Cost）
• Claude Managed Agents
• 伺服器端備援（fallbacks 參數；請改用用戶端備援模式）



Bedrock 上的 PDF 支援

Bedrock 透過 Converse API 和 InvokeModel API 提供 PDF 支援。如需有關 PDF 處理功能和限制的詳細資訊，請參閱 Amazon Bedrock PDF 支援。

Converse API 使用者的重要注意事項：

• 視覺化 PDF 分析（圖表、圖片、版面配置）需要啟用引用功能
• 若未啟用引用，則僅提供基本的文字擷取
• 如需完全控制且不強制使用引用，請使用 InvokeModel API



上下文視窗

Claude Fable 5、Claude Opus 5、Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6、Claude Sonnet 5 和 Claude Sonnet 4.6 在 Amazon Bedrock 上具有 100 萬 token 的上下文視窗。其他 Claude 模型，包括 Sonnet 4.5 和 Sonnet 4（已棄用），具有 20 萬 token 的上下文視窗。

Bedrock 將請求承載限制為 20 MB。傳送大型文件或大量圖片時，您可能會在達到 token 限制之前先達到此限制。



全域與區域端點

從 Claude Sonnet 4.5 和所有未來模型開始，Bedrock 提供兩種端點類型：

• 全域端點： 動態路由以獲得最大可用性
• 區域端點： 保證資料透過特定地理區域路由

區域端點的定價比全域端點高出 10%。



何時使用各選項

全域端點（建議）：

• 提供最大的可用性和正常運作時間
• 動態將請求路由到有可用容量的區域
• 無額外定價費用
• 最適合資料落地要求較彈性的應用程式

區域端點（CRIS）：

• 透過特定地理區域路由流量
• 資料落地和合規要求所必需
• 適用於美國、歐盟、日本和亞太地區
• 10% 的定價溢價反映了專用區域容量的基礎設施成本



實作

使用全域端點（Opus 4.6、Sonnet 4.6 和 Sonnet 4.5 的預設值）：

Claude Opus 4.6、Sonnet 4.6 和 Sonnet 4.5 的模型 ID 已包含 global. 前綴：

使用區域端點（CRIS）：

若要使用區域端點，請將 global. 前綴替換為區域前綴，例如 us.：



其他資源

• Bedrock 定價： Amazon Bedrock 定價頁面
• AWS 定價文件： Bedrock 定價指南
• AWS 部落格文章： 在 Amazon Bedrock 中推出 Claude Sonnet 4.5
• Anthropic 定價詳細資訊： 雲端平台定價