语义排序器是一项高级功能，按使用情况计费。 默认情况下，所有搜索服务都注册在免费计划中，该计划免费提供每月请求津贴。 若要在使用免费配额后启用继续访问，可以切换到标准计划。
从搜索服务 REST API 版本 2026-04-01 开始，语义排名器和代理检索的计费许可是分开的。 使用 semanticSearch 控制语义排序器的计费，使用 knowledgeRetrieval 控制智能检索的计费。
先决条件
对于搜索服务 REST API 版本 2026-04-01 及更高版本， semanticSearch 仅影响语义排名器计费。 若要控制代理检索计费，请参阅 启用或禁用代理检索计费。
对于搜索服务 REST API 版本 2025-11-01-preview 及更早的版本，semanticSearch 控制对语义排名器和付费代理主动检索使用情况的同意。
计费计划
语义排名器有两个计费计划。 有关以货币计价的信息，请参阅 Azure AI 搜索 定价。
| Plan |
Description |
Availability |
| 免费（默认值） |
提供每月免费请求限额。 在免费额度用尽后，语义排名器请求将返回计费错误。 |
在所有定价层上都可用。 |
| 标准 |
在使用完每月免费额度后，采用按使用量计费的方式。 |
需要基本层或更高版本。 |
启用语义排名器计费
请按照以下步骤将语义排序器切换为标准计费计划。 计费计划适用于服务级别并影响所有索引。
在 Azure 门户中，转到你的搜索服务。
在 “概述 ”页上，确保定价层为“基本”或“更高”。
在左窗格中，选择“设置>功能。
在语义排名器下，选择标准卡中的“选择计划”。
使用服务 - 创建或更新（搜索管理 REST API）将semanticSearch设置为standard：
PATCH https://management.chinacloudapi.cn/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2026-03-01-preview
Content-Type: application/json
Authorization: Bearer {{token}}
{
"properties": {
"semanticSearch": "standard"
}
}
管理 REST API 调用通过Microsoft Entra ID进行身份验证。 有关如何进行身份验证的说明，请参阅 使用 REST API 管理Azure AI 搜索服务。
注释
创建或更新支持两种 HTTP 方法：PUT 和 PATCH。 PUT 和 PATCH 都可用于更新现有服务，但只有 PUT 可以用来创建新服务。 使用 PUT 来更新现有服务时，如果未在请求中指定属性，则会将服务中的所有属性替换为默认值。 使用 PATCH 来更新现有服务时，它只会替换请求中指定的属性。 使用 PUT 更新现有服务时，可能会意外引入意外的缩放或配置更改。 在现有服务上启用语义排名时，建议使用 PATCH 而不是 PUT。
禁用语义排名器计费
请按照以下步骤将语义排序器恢复为免费计费计划。
在 Azure 门户中，转到你的搜索服务。
在左窗格中，选择“设置>功能。
在语义排名器下，选择免费卡中的“选择计划”。
使用服务 - 创建或更新（搜索管理 REST API）将semanticSearch设置为free：
PATCH https://management.chinacloudapi.cn/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2026-03-01-preview
Content-Type: application/json
Authorization: Bearer {{token}}
{
"properties": {
"semanticSearch": "free"
}
}
管理 REST API 调用通过Microsoft Entra ID进行身份验证。 有关如何进行身份验证的说明，请参阅 使用 REST API 管理Azure AI 搜索服务。
注释
该值 disabled 在搜索管理 REST API 版本 2026-03-01-preview 及更高版本中不再有效。 设置为semanticSearchdisabled的现有服务将被自动视为free。
后续步骤
