啟用或停用語意排序計費

語意排名器是按使用次數收費的高級功能。 預設情況下，所有搜尋服務都註冊於免費方案，該方案每月可免費提供申請額度。 若要在免費配額用盡後繼續使用，您可以切換到標準方案。

從 Search Service REST API 版本 2026-04-01 開始，語意排序器和代理檢索的計費同意是分開的。 用 semanticSearch 控制語意排序器的計費，並用 knowledgeRetrieval 控制代理檢索的計費。

先決條件

• 任何地區的 Azure AI 搜尋服務 服務提供語意排序器。

• 搜尋服務的擁有者或貢獻者權限。

• 搜尋管理 REST API 版本 2026-03-01-preview 或更新版本以設定該 semanticSearch 屬性。

帳單分割與入口網站行為

你可以用搜尋管理 REST API 設定帳單同意。 下表顯示根據您的應用程式所使用的搜尋服務 REST API 版本，哪個屬性會生效。

Search Service REST API 版本	語意排序計費	代理檢索計費
2026-04-01 及之後	由semanticSearch控制	由 knowledgeRetrieval 控制
2025-11-01-預覽版 及更早	由 semanticSearch 控制	由 semanticSearch 控制

對於 Search Service REST API 版本 2026-04-01 及以後版本，semanticSearch 僅影響語意排序器計費。 要控制代理檢索計費，請參見 啟用或停用代理檢索計費。

對於 Search Service REST API 版本 2025-11-01-preview 及更早的版本，semanticSearch 管理語義排名器與付費代理檢索使用的同意。

門戶運作行為

Azure入口使用搜尋服務 REST API 版本 2025-11-01-preview，該版本設定了 semanticSearch 屬性。 在此版本中，semanticSearch 控制語義排序和代理檢索的計費同意，因此 設定>高級功能 切換會影響這兩個功能。

計費計畫

語意排名器有兩種計費方案。 關於按貨幣定價，請參見Azure AI 搜尋服務定價。

計畫	描述
免費（預設）	每月提供免費請求津貼。 當免費額度被消耗後，語意排序器請求會返回計費錯誤。 所有價格層級皆有販售。
標準	在每月免費津貼用罄後，採用按需付費的價格模式。 需要基本等級或更高等級。

啟用語意排序計費

請依照以下步驟將語意排名器切換到標準計費方案。 計費方案適用於服務層級，並影響所有索引。

Azure portal

重要

目前，使用入口網站切換方案也會影響代理檢索計費。 更多資訊請參見 入口網站行為。

1. 在Azure 入口網站中，進入您的搜尋服務。

2. 在 概覽 頁面，確保價格等級是基本或更高。

3. 從左側窗格選擇 「設定>高級功能」。

4. 選擇標準。

REST

使用 Services - 建立或更新 （Search Management REST API）來設定 semanticSearch 為 standard：

PATCH https://management.azure.com/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"
  }
}

Management REST API 呼叫透過 Microsoft Entra ID 進行認證。 關於如何認證的說明，請參見 用 REST API 管理你的Azure AI 搜尋服務服務。

註

建立或更新支援兩種 HTTP 方法：PUT 和 PATCH。 PUT 和 PATCH 都可以用來更新現有服務，但只有 PUT 可以用來建立新服務。 如果使用 PUT 來更新現有服務，如果請求中未指定，它會將服務中所有屬性替換為預設值。 當使用 PATCH 更新現有服務時，它只會替換請求中指定的屬性。 使用 PUT 更新現有服務時，可能會意外引入意想不到的擴展或設定變更。 在現有服務啟用語意排名時，建議使用 PATCH 而非 PUT。

停用語意排序計費

請依照以下步驟將語意排名器切換回免費計費方案。

Azure portal

重要

目前，使用入口網站切換方案也會影響代理檢索計費。 更多資訊請參見 入口網站行為。

1. 在Azure 入口網站中，進入您的搜尋服務。

2. 從左側窗格選擇 「設定>高級功能」。

3. 選擇 自由。

   

REST

使用 Services - Create/Update（Search Management REST API）來設定 semanticSearch 為 free：

PATCH https://management.azure.com/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"
  }
}

Management REST API 呼叫透過 Microsoft Entra ID 進行認證。 關於如何認證的說明，請參見 用 REST API 管理你的Azure AI 搜尋服務服務。

註

該 disabled 值在搜尋管理 REST API 版本 2026-03-01-preview 及以後版本中不再有效。 現有服務將semanticSearch設置為disabled時會被自動視為free。

下一步

配置語意排名器