本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon Connect Voice ID 發言者、監視清單和詐騙者管理 API
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
Amazon Connect Voice ID 包含用於管理註冊到語音 ID 網域的發言者和在網域中註冊的詐騙者的 API。所有發言者 API (`ListSpeakers` 除外) 都接受 `CustomerSpeakerId` 或 `GeneratedSpeakerId`。
## 發言者管理 API
1. [DescribeSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeSpeaker.html)：描述[網域中發言者的狀態 (已註冊、OPTED\$1OUT、已註冊)](voiceid-domain.md#voiceid-speaker-enrollments)，並將 `GeneratedSpeakerId` 對應到 `CustomerSpeakerId`，反之亦然。
1. [DescribeSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteSpeaker.html)：從語音 ID 網域中完全刪除來電者/發言者的所有記錄。所有聲紋和註冊狀態都會立即刪除，並在 24 小時內刪除相關的錄音。
1. [ListSpeakers](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListSpeakers.html)：列出其項目存在於語音 ID 網域中的所有發言者。此 API 傳回發言者的 `CustomerSpeakerId` 和 `GeneratedSpeakerId`。它傳回與 API 請求指定的頁面大小的分頁輸出。
1. [OptOutSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_OptOutSpeaker.html)：從語音識別網域中選擇退出來電者。此 API 不需要發言者出現在語音 ID 中。不存在的發言者可以使用此 API 選擇退出，語音 ID 會保留選擇退出狀態，並拒絕此發言者的未來註冊請求。選擇退出也會移除此來電者的聲紋和任何儲存的錄音。
## 監視清單管理 API
1. [CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html)：建立監視清單，詐騙者可以成為其中的一部分。
1. [DeleteWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteWatchlist.html)：從語音 ID 網域中刪除自訂詐騙者監視清單。若要刪除監視清單，該清單必須為空白。也就是說，它不得有任何與之關聯的詐騙者。您可以使用 [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html) 或 [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html) API 以利從監視清單中刪除所有詐騙者。
您無法從語音 ID 網域刪除預設監視清單。
1. [DescribeWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeWatchlist.html)：確定它是預設的詐騙者監視清單還是您建立的自訂監視清單，並獲取監視清單詳細資訊。
1. [ListWatchlists](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListWatchlists.html)：列出語音 ID 網域中的所有監視清單。
1. [UpdateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateWatchlist.html)：更新自訂詐騙者監視清單的名稱和描述。您無法修改預設監視清單的詳細資料，因為它是由語音 ID 管理。
## 詐騙者管理 API
1. [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html)：將詐騙者與同網域中的監視清單建立關聯。您可以將詐騙者與網域中的多個監視清單建立關聯。
1. [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html)：從語音 ID 網域刪除詐騙者。刪除詐騙者會將詐騙者從其所屬的所有監視清單中刪除。它還會在 24 小時內刪除所有聲紋和相關的錄音。
1. [DescribeFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeFraudster.html)：描述詐騙者在語音 ID 網域中的狀態。
1. [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html)：取消詐騙者與指定監視清單的關聯。請注意，詐騙者始終必須與至少一個詐騙者監視清單相關聯；如果您嘗試將詐騙者與其唯一監視清單取消關聯，則會發生例外狀況。
要完全刪除詐騙者，請使用 `DeleteFraudster`。
1. [ListFraudsters](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListFraudsters.html)：列出網域或特定監視清單中的所有詐騙者。此 API 還會傳回詐騙者所屬的監視清單。它傳回與 API 請求指定的頁面大小的分頁輸出。