快速入門：文字的受保護材料偵測
文字的受(版權)保護素材功能提供完整的解決方案，以管理與 AI 產生的內容 (僅英文內容) 相關聯的風險。 藉由偵測及防止顯示受保護的素材，組織可以確保遵守智慧財產權法、維護內容原創性，以及保護其聲譽。 受保護的素材是指符合版權來源 (例如歌曲歌詞、文章、食譜或其他選取的 Web 內容) 已知文字的內容。
AI 產生內容的文字受(版權)保護素材偵測功能的主要目標是：
- 偵測並防止顯示 AI 模型所產生的受保護內容。
- 讓組織能夠管理與 AI 產生的內容相關聯的風險。
- 為了確保 AI 產生的內容符合法律、道德和內容原則指導方針。
如需關於受(版權)保護素材偵測的詳細資訊，請參閱受(版權)保護素材偵測概念頁面。 如需 API 輸入限制，請參閱概觀的輸入要求一節。
必要條件
- Azure 訂用帳戶 - 建立免費帳戶
- 擁有 Azure 訂用帳戶之後，在 Azure 入口網站中建立 Content Safety 資源，以取得您的金鑰和端點。 輸入您資源的唯一名稱，選取您的訂用帳戶，然後選取資源群組、支援的區域 (參閱區域可用性) 以及支援的定價層。 然後選取建立。
- 部署資源需要幾分鐘的時間。 完成後，選取 [移至資源]。 在左側窗格中，於 [資源管理] 下選取 [訂用帳戶金鑰和端點]。 端點和其中一個金鑰是用以呼叫 API。
- 已安裝 cURL
受(版權)保護素材偵測的分析文字
下一節會逐步解說 cURL 的範例要求。 將下列命令貼上至文字編輯器，並進行下列變更。
- 將
<endpoint>取代為與資源相關聯的端點 URL。 - 將
<your_subscription_key>取代為資源自帶的金鑰之一。 - 或者，將本文中的
"text"欄位取代為您要分析的文字。提示
如需文字長度上限的資訊，請參閱輸入需求。 受(版權)保護素材偵測是要在 LLM 完成時執行，而不是使用者提示。
curl --location --request POST '<endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"text": "Kiss me out of the bearded barley Nightly beside the green, green grass Swing, swing, swing the spinning step You wear those shoes and I will wear that dress Oh, kiss me beneath the milky twilight Lead me out on the moonlit floor Lift your open hand Strike up the band and make the fireflies dance Silver moon's sparkling So, kiss me Kiss me down by the broken tree house Swing me upon its hanging tire Bring, bring, bring your flowered hat We'll take the trail marked on your father's map."
}'
下欄欄位必須包含在 URL 中：
| 名稱 | 是必要的嗎? | 描述 | 類型 |
|---|---|---|---|
| API 版本 | 必要 | 這是要檢查的 API 版本。 目前的版本為：api-version=2024-09-01。 範例: <endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01 |
String |
要求本文中的參數在此表中定義：
| 名稱 | 是必要的嗎? | 描述 | 類型 |
|---|---|---|---|
| text | 必要 | 這是要檢查的原始文字。 可以包含其他非 ascii 字元。 | String |
請參閱下列範例要求本文：
{
"text": "string"
}
開啟命令提示字元視窗並執行 cURL 命令。
解譯 API 回應
您應該會在主控台輸出中看到顯示為 JSON 資料的受(版權)保護素材結果。 例如：
{
"protectedMaterialAnalysis": {
"detected": true
}
}
輸出中的 JSON 欄位定義如下：
| 名稱 | 描述 | 類型 |
|---|---|---|
| protectedMaterialAnalysis | API 預測的每個輸出類別。 | String |
| detected | 是否偵測到受(版權)保護素材。 | 布林值 |
清除資源
如果您想要清除和移除 Azure AI 服務訂用帳戶，則可以刪除資源或資源群組。 刪除資源群組也會刪除與其相關聯的任何其他資源。
相關內容
- 受(版權)保護素材偵測概念
- 使用 Content Safety Studio 設定每個類別和測試資料集的篩選，匯出程式碼並部署。