View a markdown version of this page

亚马逊 Bedrock 支持的终端节点 - Amazon Bedrock

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

亚马逊 Bedrock 支持的终端节点

Amazon Bedrock 支持各种终端节点来执行推理操作。

推理操作

对于新应用程序,我们推荐使用bedrock-runtime终端节点。它支持 Bedrock-native InvokeModel Converse API、 OpenAI-compatible 响应聊天完成 API 以及 Anthropic M essages API,也是在此可用的 Amazon Bedrock 功能,例如护栏智能提示路由和跨区域推理。将模型推理请求路由到各处 AWS 区域 使用跨区域推断Amazon Bedrock 还支持第二个终端节点bedrock-mantle,该终端节点目前提供其他功能,例如服务器端和预配置工具的使用(包括网络搜索)、使用异步推理以及创建项目和工作空间。background=true 工作空间 () Anthropic-compatible要查看每个模型支持哪个端点,请参阅各型号的端点可用性

Endpoint 支持的 API 描述
bedrock-runtime.{region}.amazonaws.com(推荐) InvokeModel/交谈/聊天完成/回复 API /消息 API Region-specific 用于使用 API 对亚马逊基岩中托管的模型提出推理请求的终端节点。 InvokeModel/Converse/Chat Completions/Responses/Messages 有关这些 Bedrock-native 操作的更多信息,请参阅亚马逊 Bedrock 运行时 API 操作。 OpenAI-compatible API 是通过此端点的/openai/v1路径调用的,而不是通过 AWS SDK 调用的。
bedrock-mantle.{region}.api.aws 回复 API/聊天完成 API/消息 API Region-specific 用于使用终端节点和 Anthropic Messages API 对托管在 Amazon Bedrock 中的模型提出推理请求的 OpenAI-compatible 终端节点。

使用的现有应用程序bedrock-mantle将继续得到完全支持,无需更改。这两个终端节点都允许您通过仅更改基本网址和API密钥将现有的OpenAI SDK代码库引入亚马逊Bedrock,并且都支持 OpenAI-compatible 响应和聊天完成 API 以及 Anthropic Messages API。

下表比较了每个端点上的可用内容。

注意

消息 API 在两个端点上都可用,但这两个界面不支持相同的功能。特别是,不支持结构化输出output_config.format参数),包含的bedrock-mantle请求会output_config.format被拒绝,错误为 400。要在 Anthropic Claude 模型中使用结构化输出,请调用 Converse 或 InvokeModel API。bedrock-runtime

注意

响应API也可在两个端点上使用,但不支持相同的功能。在 bedrock-runtime 上:

  • 请求始终是同步的。background=true因 400 错误而被拒绝。该store参数不受影响,其默认值保持不变true,因此存储的多回合对话可以正常运行。

  • Server-side 工具使用和预先配置的工具不可用,包括网络搜索。 Client-side 工具的使用适用于两个端点。

  • 仅支持默认项目。请参阅项目 (OpenAI-compatible)

  • 存储的响应属于提供 AWS 区域 该响应的人。检索、取消或删除它以及继续与previous_response_id之对话均由该地区处理。

注意

开启bedrock-runtime只有 I AM 委托人使用响应 API 属性。 Per-request 元数据标记和应用程序推理配置文件在其上不可用——将应用程序推理配置文件命名为其推理目标的请求会被拒绝,错误为 400。这不会影响跨区域推理:系统定义的地理和全球推理配置文件可以正常运行。

基岩功能可用性
功能 bedrock-runtime bedrock-mantle
护栏
提示缓存
智能提示路由
注意

是否支持及时缓存bedrock-mantle取决于具体型号——有关详细信息,请参阅下面的每个型号卡。模型一览

吞吐量和配额方法

每个终端使用不同的方法来管理吞吐量。

  • bedrock-runtime— 在许多传统的多租户服务中,该架构是围绕每个账户的配额设计的,用于管理对共享资源的公平共享访问权限。这是使用的方法bedrock-runtime。每种型号都有固定的吞吐量配额(RPM 和 TPM),您可以申请提高。有关更多信息,请参阅 基岩运行时端点的配额

  • bedrock-mantle— 该端点采用先进的调度和工作队列机制构建,可在支持更高的初始吞吐量限制的同时提供公平的分配。这种设计还bedrock-mantle允许托管广泛的模型,并提供模型目录中可用的全部功能。在大多数情况下,请求会立即得到处理。在某些情况下,请求可能会在飞行中的工作负载完成且吞吐量可用时短暂排队。有关详细信息,请参阅 基岩地幔端点的配额扩展和吞吐量最佳实践

定价

Per-token bedrock-runtime和上相同型号的定价相同bedrock-mantle。根据所需的 API 和功能选择终端节点,而不是成本。有关当前定价,请参阅亚马逊 Bedrock 定价

何时选择每个端点

从你想要的bedrock-runtime时候开始:

bedrock-mantle在你想的时候使用:

两个端点可以在同一个应用程序中一起使用——按用例选择。

使用 VPC 接口终端节点降低数据输出成本

如果您从 VPC 内部调用 Amazon Bedrock,请考虑使用 VPC 接口终端节点 (AWS PrivateLink) 将流量保持在 AWS 网络内,并避免与 NAT 网关或互联网网关相关的数据出口费用。