Amazon Bedrock 上的 Claude(bedrock-runtime)

通过 InvokeModel 和 Converse API,在 Amazon Bedrock 的 bedrock-runtime 端点上使用 Claude 模型。

通过 Bedrock 调用 Claude 与直接通过 Claude API 调用 Claude 的方式略有不同。本指南将引导您使用 Anthropic 的某个客户端 SDK 完成对 Bedrock 上 Claude 的 API 调用。

请注意,本指南假设您已经注册了 AWS 账户并配置了编程访问。

安装和配置 AWS CLI

  1. 安装 AWS CLI,版本需为 2.13.23 或更高。
  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。

Python

示例代码
pip install -U "anthropic[bedrock]<2"

TypeScript

示例代码
npm install @anthropic-ai/bedrock-sdk@0

列出可用模型 中的示例还需要 AWS 的 Bedrock 客户端。使用 npm install @aws-sdk/client-bedrock 安装它。

C#

示例代码
dotnet add package Anthropic.Bedrock --version 0.14.1

如果您的项目还引用了 Anthropic 包,请将其保持在版本 13 以下。

列出可用模型 中的示例还需要 AWS 的 Bedrock 客户端。使用 dotnet add package AWSSDK.Bedrock 安装它。

Go

示例代码
go get github.com/anthropics/anthropic-sdk-go/bedrock

列出可用模型 中的示例还需要 AWS 的 Bedrock 客户端。使用 go get github.com/aws/aws-sdk-go-v2/service/bedrock 安装它。

Java

示例代码
implementation("com.anthropic:anthropic-java:2.+")
implementation("com.anthropic:anthropic-java-bedrock:2.+")
示例代码
<dependency>
    <groupId>com.anthropic</groupId>
    <artifactId>anthropic-java</artifactId>
    <version>[2.0.0,3.0.0)</version>
</dependency>
<dependency>
    <groupId>com.anthropic</groupId>
    <artifactId>anthropic-java-bedrock</artifactId>
    <version>[2.0.0,3.0.0)</version>
</dependency>
示例代码
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.bedrock.backends.BedrockBackend;
import com.anthropic.models.messages.MessageCreateParams;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.Model;

public class BasicMessage {
    public static void main(String[] args) {
        AnthropicClient client = AnthropicOkHttpClient.builder()
            .backend(BedrockBackend.fromEnv())
            .build();

        MessageCreateParams params = MessageCreateParams.builder()
            .model(Model.CLAUDE_OPUS_4_6)
            .maxTokens(1024L)
            .addUserMessage("What is the capital of France?")
            .build();

        Message response = client.messages().create(params);
        response.content().stream()
            .flatMap(block -> block.text().stream())
            .forEach(textBlock -> System.out.println(textBlock.text()));
    }
}

列出可用模型 中的示例还需要 AWS 的 Bedrock 客户端。将 software.amazon.awssdk:bedrock 添加到您的构建中。

PHP

示例代码
composer require "anthropic-ai/sdk:<1.0" aws/aws-sdk-php

Ruby

示例代码
# Gemfile
gem "anthropic", "~> 1.0"
gem "aws-sdk-bedrockruntime"

列出可用模型 中的示例还需要 AWS 的 Bedrock 客户端。将 gem "aws-sdk-bedrock" 添加到您的 Gemfile 中。

Boto3 (Python)

示例代码
pip install "boto3>=1.28.59"

访问 Bedrock

订阅 Anthropic 模型

前往 AWS Console > Bedrock > 模型访问并申请访问 Anthropic 模型。请注意,Anthropic 模型的可用性因区域而异。有关最新信息,请参阅 AWS 关于各区域模型可用性的文档。

API 模型 ID

生命周期术语(Deprecated(已弃用)、Retired(已停用))的定义请参阅模型弃用。合作伙伴运营平台上的生命周期日期由合作伙伴设定,可能与 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 前加上下表中标记为"是"的列所对应的前缀,例如 us.anthropic.claude-sonnet-4-5-20250929-v1:0。您也可以传入完整的推理配置文件 ARN,格式为 arn:aws:bedrock:{region}:{account-id}:inference-profile/{inference-profile-id}。有关 AWS 官方提供的可用推理配置文件列表,请参阅推理配置文件支持的区域和模型。要了解前缀如何影响路由和定价,请参阅全局端点与区域端点部分。

ModelBase Bedrock model IDglobaluseujpapac
Claude Fable 5.2anthropic.claude-fable-5-2YesYesNoNoNo
Claude Mythos 5.2 (limited availability)anthropic.claude-mythos-5-2YesYesNoNoNo
Claude Opus 4.6anthropic.claude-opus-4-6-v1YesYesYesYesYes
Claude Opus 4.5anthropic.claude-opus-4-5-20251101-v1:0YesYesYesNoNo
Claude Opus 4.1 (deprecated)anthropic.claude-opus-4-1-20250805-v1:0NoYesNoNoNo
Claude Sonnet 4.6anthropic.claude-sonnet-4-6YesYesYesYesNo
Claude Sonnet 4.5 (deprecated)anthropic.claude-sonnet-4-5-20250929-v1:0YesYesYesYesNo
Claude Sonnet 4 (deprecated)anthropic.claude-sonnet-4-20250514-v1:0YesYesYesNoYes
Claude Haiku 4.5anthropic.claude-haiku-4-5-20251001-v1:0YesYesYesNoNo

列出可用模型

以下示例展示如何打印通过 Bedrock 可用的所有 Claude 模型列表:

示例代码
aws bedrock list-foundation-models --region=us-west-2 --by-provider anthropic --query "modelSummaries[*].modelId"
示例代码
import boto3

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

for summary in response["modelSummaries"]:
    print(summary["modelId"])
示例代码
import { BedrockClient, ListFoundationModelsCommand } from "@aws-sdk/client-bedrock";

const client = new BedrockClient({ region: "us-west-2" });

const command = new ListFoundationModelsCommand({ byProvider: "anthropic" });
const response = await client.send(command);

if (response.modelSummaries) {
  for (const summary of response.modelSummaries) {
    console.log(summary.modelId);
  }
}
示例代码
using Amazon;
using Amazon.Bedrock;
using Amazon.Bedrock.Model;

var client = new AmazonBedrockClient(RegionEndpoint.USWest2);

var request = new ListFoundationModelsRequest
{
    ByProvider = "anthropic"
};

var response = await client.ListFoundationModelsAsync(request);

foreach (var summary in response.ModelSummaries)
{
    Console.WriteLine(summary.ModelId);
}
示例代码
import (
	"context"
	"fmt"
	"log"

	"github.com/aws/aws-sdk-go-v2/config"
	"github.com/aws/aws-sdk-go-v2/service/bedrock"
)
// ...
	cfg, err := config.LoadDefaultConfig(context.TODO(), config.WithRegion("us-west-2"))
	if err != nil {
		log.Fatal(err)
	}

	client := bedrock.NewFromConfig(cfg)

	byProvider := "anthropic"
	response, err := client.ListFoundationModels(context.TODO(), &bedrock.ListFoundationModelsInput{
		ByProvider: &byProvider,
	})
	if err != nil {
		log.Fatal(err)
	}

	for _, summary := range response.ModelSummaries {
		fmt.Println(*summary.ModelId)
	}
示例代码
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.bedrock.BedrockClient;
import software.amazon.awssdk.services.bedrock.model.ListFoundationModelsRequest;
import software.amazon.awssdk.services.bedrock.model.ListFoundationModelsResponse;
import software.amazon.awssdk.services.bedrock.model.FoundationModelSummary;

public class ListAnthropicModels {
    public static void main(String[] args) {
        BedrockClient client = BedrockClient.builder()
            .region(Region.US_WEST_2)
            .build();

        ListFoundationModelsRequest request = ListFoundationModelsRequest.builder()
            .byProvider("anthropic")
            .build();

        ListFoundationModelsResponse response = client.listFoundationModels(request);

        for (FoundationModelSummary summary : response.modelSummaries()) {
            System.out.println(summary.modelId());
        }

        client.close();
    }
}
示例代码
<?php

use Aws\Bedrock\BedrockClient;

$client = new BedrockClient([
    'region' => 'us-west-2',
    'version' => 'latest'
]);

$result = $client->listFoundationModels([
    'byProvider' => 'anthropic'
]);

foreach ($result['modelSummaries'] as $summary) {
    echo $summary['modelId'] . PHP_EOL;
}
示例代码
require "aws-sdk-bedrock"

client = Aws::Bedrock::Client.new(region: "us-west-2")

response = client.list_foundation_models({
  by_provider: "anthropic"
})

response.model_summaries.each do |summary|
  puts summary.model_id
end

发送请求

以下示例展示如何在 Bedrock 上使用 Claude 生成文本:

cURL

CLI

Python

示例代码
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 区域。如未提供,SDK 会读取
    # AWS_REGION / AWS_DEFAULT_REGION,然后读取您的 boto3 会话或 AWS 配置文件中配置的区域
    # (包括 ~/.aws/config),如果无法解析出任何区域,则抛出 ValueError。
    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)

TypeScript

示例代码
import AnthropicBedrock from "@anthropic-ai/bedrock-sdk";

const client = new AnthropicBedrock({
  // 可通过提供以下密钥进行身份验证,或使用
  // 默认的 AWS 凭证提供程序,例如
  // ~/.aws/credentials 或 "AWS_SECRET_ACCESS_KEY" 和
  // "AWS_ACCESS_KEY_ID" 环境变量。
  awsAccessKey: "<access key>",
  awsSecretKey: "<secret key>",

  // 可通过 awsSessionToken 使用临时凭证。
  // 详情请参阅 https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html。
  awsSessionToken: "<session_token>",

  // awsRegion 用于更改请求发送到的
  // AWS 区域。默认情况下,SDK 读取 AWS_REGION,如果
  // 未设置,则默认为 us-east-1。请注意,
  // SDK 不会从 ~/.aws/config 读取区域。
  awsRegion: "us-west-2"
});

const message = await client.messages.create({
  model: "global.anthropic.claude-opus-4-6-v1",
  max_tokens: 256,
  messages: [{ role: "user", content: "Hello, world" }]
});
console.log(message);

C#

示例代码
using Anthropic.Bedrock;
using Anthropic.Models.Messages;

AnthropicBedrockClient client = new(
    await AnthropicBedrockCredentialsHelper.FromEnv()
    ?? throw new InvalidOperationException("AWS credentials not configured.")
);

var response = await client.Messages.Create(new MessageCreateParams
{
    Model = "global.anthropic.claude-opus-4-6-v1",
    MaxTokens = 256,
    Messages = [new() { Role = Role.User, Content = "Hello, world" }],
});

Console.WriteLine(
    string.Join("", response.Content
        .Select(block => block.Value)
        .OfType<TextBlock>()
        .Select(textBlock => textBlock.Text)));

Go

示例代码
import (
	"context"
	"fmt"

	"github.com/anthropics/anthropic-sdk-go"
	"github.com/anthropics/anthropic-sdk-go/bedrock"
)
// ...
	// 使用默认的 AWS 凭证提供程序链
	client := anthropic.NewClient(
		bedrock.WithLoadDefaultConfig(context.Background()),
	)

	message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
		Model:     "global.anthropic.claude-opus-4-6-v1",
		MaxTokens: 256,
		Messages: []anthropic.MessageParam{
			anthropic.NewUserMessage(anthropic.NewTextBlock("Hello, world")),
		},
	})
	if err != nil {
		panic(err)
	}
	fmt.Println(message.Content)

Java

示例代码
import com.anthropic.bedrock.backends.BedrockBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.MessageCreateParams;

public class BedrockExample {

    public static void main(String[] args) {
        // 使用默认的 AWS 凭证提供程序链
        AnthropicClient client = AnthropicOkHttpClient.builder()
            .backend(BedrockBackend.fromEnv())
            .build();

        Message message = client
            .messages()
            .create(
                MessageCreateParams.builder()
                    .model("global.anthropic.claude-opus-4-6-v1")
                    .maxTokens(256)
                    .addUserMessage("Hello, world")
                    .build()
            );

        System.out.println(message.content());
    }
}

PHP

示例代码
<?php

use Anthropic\Bedrock;

$client = Bedrock\Client::withCredentials(
    accessKeyId: getenv('AWS_ACCESS_KEY_ID'),
    secretAccessKey: getenv('AWS_SECRET_ACCESS_KEY'),
    region: 'us-west-2',
    securityToken: getenv('AWS_SESSION_TOKEN'),
);

$message = $client->messages->create(
    maxTokens: 256,
    messages: [
        ['role' => 'user', 'content' => 'Hello, world']
    ],
    model: 'global.anthropic.claude-opus-4-6-v1',
);
echo $message->content[0]->text;

Ruby

示例代码
require "anthropic"

client = Anthropic::BedrockClient.new

message = client.messages.create(
  model: "global.anthropic.claude-opus-4-6-v1",
  max_tokens: 256,
  messages: [{role: "user", content: "Hello, world"}]
)

puts message.content.first.text

Boto3 (Python)

示例代码
import boto3
import json

bedrock = boto3.client(service_name="bedrock-runtime")
body = json.dumps(
    {
        "max_tokens": 256,
        "messages": [{"role": "user", "content": "Hello, world"}],
        "anthropic_version": "bedrock-2023-05-31",
    }
)

response = bedrock.invoke_model(
    body=body, modelId="global.anthropic.claude-opus-4-6-v1"
)

response_body = json.loads(response.get("body").read())
print(response_body.get("content"))

更多详情请参阅客户端 SDK以及 Bedrock 官方文档。

Bearer 令牌身份验证

您可以使用 bearer token(Bearer 令牌)而非 AWS 凭证向 Bedrock 进行身份验证。这在企业环境中非常有用,因为团队需要访问 Bedrock,但无需管理 AWS 凭证、IAM 角色或账户级权限。

最简单的方法是设置 AWS_BEARER_TOKEN_BEDROCK 环境变量,SDK 在从环境中解析凭证时会自动检测该变量。

以编程方式提供令牌:

cURL

CLI

Python

示例代码
from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    api_key="your-bearer-token",
    aws_region="us-west-2",
)

message = client.messages.create(
    model="us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)

TypeScript

示例代码
import AnthropicBedrock from "@anthropic-ai/bedrock-sdk";

const client = new AnthropicBedrock({
  apiKey: "your-bearer-token",
  awsRegion: "us-west-2"
});

const message = await client.messages.create({
  model: "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello!" }]
});
console.log(message);

C#

示例代码
using Anthropic.Bedrock;
using Anthropic.Models.Messages;

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

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!" }],
});

Go

示例代码
import (
	"context"
	"fmt"

	"github.com/anthropics/anthropic-sdk-go"
	"github.com/anthropics/anthropic-sdk-go/bedrock"
	"github.com/aws/aws-sdk-go-v2/aws"
)
// ...
	cfg := aws.Config{
		Region:                  "us-west-2",
		BearerAuthTokenProvider: bedrock.NewStaticBearerTokenProvider("your-bearer-token"),
	}
	client := anthropic.NewClient(
		bedrock.WithConfig(cfg),
	)

	message, err := client.Messages.New(context.TODO(), anthropic.MessageNewParams{
		Model:     "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
		MaxTokens: 1024,
		Messages: []anthropic.MessageParam{
			anthropic.NewUserMessage(anthropic.NewTextBlock("Hello!")),
		},
	})
	if err != nil {
		panic(err)
	}
	fmt.Println(message.Content[0].Text)

Java

示例代码
import com.anthropic.bedrock.backends.BedrockBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.MessageCreateParams;
import software.amazon.awssdk.regions.Region;

// 选项 1:设置 AWS_BEARER_TOKEN_BEDROCK 环境变量并使用 fromEnv()
AnthropicClient client = AnthropicOkHttpClient.builder()
    .backend(BedrockBackend.fromEnv())
    .build();

// 选项 2:以编程方式提供令牌
client = AnthropicOkHttpClient.builder()
    .backend(BedrockBackend.builder()
        .apiKey("your-bearer-token")
        .region(Region.US_WEST_2)
        .build())
    .build();

MessageCreateParams params = MessageCreateParams.builder()
    .model("us.anthropic.claude-sonnet-4-5-20250929-v1:0")
    .maxTokens(1024)
    .addUserMessage("Hello!")
    .build();

client.messages().create(params).content().stream()
    .flatMap(block -> block.text().stream())
    .forEach(textBlock -> System.out.println(textBlock.text()));

PHP

示例代码
<?php

use Anthropic\Bedrock;

$client = Bedrock\Client::withApiKey('your-bearer-token', 'us-west-2');

$message = $client->messages->create(
    maxTokens: 1024,
    messages: [
        ['role' => 'user', 'content' => 'Hello!']
    ],
    model: 'us.anthropic.claude-sonnet-4-5-20250929-v1:0',
);
echo $message->content[0]->text;

Ruby

示例代码
require "anthropic"

client = Anthropic::BedrockClient.new(
  api_key: "your-bearer-token",
  aws_region: "us-west-2"
)

message = client.messages.create(
  model: "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
  max_tokens: 1024,
  messages: [{role: "user", content: "Hello!"}]
)
puts message.content.first.text

活动日志记录

Bedrock 提供调用日志记录服务,允许您记录与您的使用相关的提示和补全内容。

Anthropic 建议您至少以 30 天滚动周期记录您的活动,以便了解您的活动并调查任何潜在的滥用行为。

功能支持

有关包含 Amazon Bedrock 可用性的完整功能列表,请参阅功能概览。

支持的主要功能

不支持的功能

  • 输入源(图像和文档的 URL 源、Files API)
  • 服务器端工具(代码执行、网络搜索、网页获取、advisor)
  • Agent 基础设施(Agent Skills、MCP 连接器、programmatic tool calling(程序化工具调用))
  • API 端点(Message Batches、Models、Admin、Compliance、用量和成本)
  • Claude Managed Agents
  • 服务器端回退(fallbacks 参数;请改用客户端回退模式)
  • 自动提示缓存(顶层 cache_control 字段;请改用显式缓存断点)

Bedrock 上的计算机使用和浏览器使用工具集

计算机使用和浏览器使用工具集可通过 InvokeModel API 用于以下模型:

  • Claude Fable 5.2
  • Claude Mythos 5.2
  • Claude Fable 5.1
  • Claude Fable 5
  • Claude Opus 5.5
  • Claude Opus 5
  • Claude Opus 4.8
  • Claude Sonnet 5.5
  • Claude Sonnet 5
  • Claude Haiku 5.5

要使用其中之一,请向 tools 数组添加一个类型为 computer_toolset_20260801 或 browser_toolset_20260801 的条目。这两个工具集都不需要 beta 标头。

Bedrock 上的 PDF 支持

PDF 支持可通过 Converse API 和 InvokeModel API 在 Bedrock 上使用。

Bedrock 上的对话中系统消息

对话中系统消息可通过 InvokeModel API 用于 Claude Fable 5.2、Claude Mythos 5.2、Claude Fable 5.1、Claude Fable 5、Claude Opus 5.5、Claude Opus 5、Claude Opus 4.8、Claude Sonnet 5.5 和 Claude Haiku 5.5。此功能在 Claude Sonnet 5 上不可用,请改用顶层 system 字段。对于本页模型表中的其他模型,此功能也不可用。

在 Claude Fable 5.2、Claude Mythos 5.2、Claude Fable 5.1 和 Claude Opus 5.5 上,role: "system" 消息还可以设置 output_config.effort 以在对话中更改 effort。此功能处于 beta 阶段:请将 mid-conversation-output-config-2026-07-01 添加到请求体中的 anthropic_beta 数组。如果未添加该值,或在 Claude Fable 5、Claude Opus 5 或 Claude Opus 4.8 上使用,请求将返回 400 错误:messages.N.output_config: Extra inputs are not permitted。错误中的 N 是该 system 消息在 messages 中的索引。

对于 Converse API 用户: Converse API 通过其顶层 system 参数接受系统指令。如需在对话中添加系统指令,请使用 InvokeModel API。

上下文窗口

Claude Fable 5.2、Claude Mythos 5.2、Claude Fable 5.1、Claude Fable 5、Claude Opus 5.5、Claude Opus 5、Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6、Claude Sonnet 5.5、Claude Sonnet 5、Claude Sonnet 4.6 和 Claude Haiku 5.5 在 Amazon Bedrock 上拥有 1M 令牌的上下文窗口。其他 Claude 模型,包括 Sonnet 4.5(已弃用)和 Sonnet 4(已弃用),拥有 200k 令牌的上下文窗口。

Bedrock 将请求负载限制为 20 MB。在发送大型文档或大量图像时,您可能会在达到令牌限制之前就达到此限制。

全局端点与区域端点

从 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. 前缀:

cURL

CLI

Python

示例代码
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"}],
)

TypeScript

示例代码
import AnthropicBedrock from "@anthropic-ai/bedrock-sdk";

const client = new AnthropicBedrock({
  awsRegion: "us-west-2"
});

const message = await client.messages.create({
  model: "global.anthropic.claude-opus-4-6-v1",
  max_tokens: 256,
  messages: [{ role: "user", content: "Hello, world" }]
});

C#

示例代码
using Anthropic.Bedrock;
using Anthropic.Models.Messages;

// C# Bedrock 客户端使用带区域前缀的模型 ID 进行全局路由
AnthropicBedrockClient client = new(
    await AnthropicBedrockCredentialsHelper.FromEnv()
    ?? throw new InvalidOperationException("AWS credentials not configured.")
);

var response = await client.Messages.Create(new MessageCreateParams
{
    // 使用 "global." 前缀进行全局跨区域推理
    Model = "global.anthropic.claude-opus-4-6-v1",
    MaxTokens = 256,
    Messages = [new() { Role = Role.User, Content = "Hello, world" }],
});

Go

示例代码
import (
	"context"

	"github.com/anthropics/anthropic-sdk-go"
	"github.com/anthropics/anthropic-sdk-go/bedrock"
)
// ...
	// 使用默认的 AWS 凭证提供程序链
	client := anthropic.NewClient(
		bedrock.WithLoadDefaultConfig(context.Background()),
	)

	message, _ := client.Messages.New(context.Background(), anthropic.MessageNewParams{
		Model:     "global.anthropic.claude-opus-4-6-v1",
		MaxTokens: 256,
		Messages: []anthropic.MessageParam{
			anthropic.NewUserMessage(anthropic.NewTextBlock("Hello, world")),
		},
	})

Java

示例代码
import com.anthropic.bedrock.backends.BedrockBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.MessageCreateParams;

// 使用默认的 AWS 凭证提供程序链
AnthropicClient client = AnthropicOkHttpClient.builder()
    .backend(BedrockBackend.fromEnv())
    .build();

var message = client
    .messages()
    .create(
        MessageCreateParams.builder()
            .model("global.anthropic.claude-opus-4-6-v1")
            .maxTokens(256)
            .addUserMessage("Hello, world")
            .build()
    );

PHP

示例代码
<?php

use Anthropic\Bedrock;

$client = Bedrock\Client::fromEnvironment();

$message = $client->messages->create(
    maxTokens: 256,
    messages: [
        ['role' => 'user', 'content' => 'Hello, world']
    ],
    model: 'global.anthropic.claude-opus-4-6-v1',
);

Ruby

示例代码
require "anthropic"

# 默认凭证从 AWS_REGION 环境变量解析区域
client = Anthropic::BedrockClient.new

message = client.messages.create(
  # 使用 "global." 前缀进行全局跨区域推理
  model: "global.anthropic.claude-opus-4-6-v1",
  max_tokens: 256,
  messages: [{role: "user", content: "Hello, world"}]
)

使用区域端点(CRIS):

要使用区域端点,请将 global. 前缀替换为区域前缀,例如 us.:

cURL

CLI

Python

示例代码
from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

# 使用美国区域端点(CRIS)
message = client.messages.create(
    model="us.anthropic.claude-opus-4-6-v1",  # Regional prefix
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

TypeScript

示例代码
import AnthropicBedrock from "@anthropic-ai/bedrock-sdk";

const client = new AnthropicBedrock({
  awsRegion: "us-west-2"
});

// 使用美国区域端点(CRIS)
const message = await client.messages.create({
  model: "us.anthropic.claude-opus-4-6-v1", // Regional prefix
  max_tokens: 256,
  messages: [{ role: "user", content: "Hello, world" }]
});

C#

示例代码
using Anthropic.Bedrock;
using Anthropic.Models.Messages;

// 默认凭证从 AWS_REGION 环境变量解析区域
AnthropicBedrockClient client = new(
    await AnthropicBedrockCredentialsHelper.FromEnv()
    ?? throw new InvalidOperationException("AWS credentials not configured.")
);

// 使用美国区域端点(CRIS)
var response = await client.Messages.Create(new MessageCreateParams
{
    Model = "us.anthropic.claude-opus-4-6-v1", // Regional prefix
    MaxTokens = 256,
    Messages = [new() { Role = Role.User, Content = "Hello, world" }],
});

Go

示例代码
import (
	"context"

	"github.com/anthropics/anthropic-sdk-go"
	"github.com/anthropics/anthropic-sdk-go/bedrock"
)
// ...
	// 使用默认的 AWS 凭证提供程序链
	client := anthropic.NewClient(
		bedrock.WithLoadDefaultConfig(context.Background()),
	)

	// 使用美国区域端点(CRIS)
	message, _ := client.Messages.New(context.Background(), anthropic.MessageNewParams{
		Model:     "us.anthropic.claude-opus-4-6-v1", // Regional prefix
		MaxTokens: 256,
		Messages: []anthropic.MessageParam{
			anthropic.NewUserMessage(anthropic.NewTextBlock("Hello, world")),
		},
	})

Java

示例代码
import com.anthropic.bedrock.backends.BedrockBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.MessageCreateParams;

// 使用默认的 AWS 凭证提供程序链
AnthropicClient client = AnthropicOkHttpClient.builder()
    .backend(BedrockBackend.fromEnv())
    .build();

// 使用美国区域端点(CRIS)
var message = client
    .messages()
    .create(
        MessageCreateParams.builder()
            .model("us.anthropic.claude-opus-4-6-v1") // Regional prefix
            .maxTokens(256)
            .addUserMessage("Hello, world")
            .build()
    );

PHP

示例代码
<?php

use Anthropic\Bedrock;

$client = Bedrock\Client::fromEnvironment();

$message = $client->messages->create(
    maxTokens: 256,
    messages: [
        ['role' => 'user', 'content' => 'Hello, world']
    ],
    model: 'us.anthropic.claude-opus-4-6-v1',
);

Ruby

示例代码
require "anthropic"

# 使用美国区域端点 (CRIS)
client = Anthropic::BedrockClient.new(aws_region: "us-west-2")

message = client.messages.create(
  model: "us.anthropic.claude-opus-4-6-v1", # Regional prefix
  max_tokens: 256,
  messages: [{role: "user", content: "Hello, world"}]
)

其他资源

文档内容持续同步更新