開始使用 Perspective API

1. 事前準備

Perspective API 是免費的 API，可協助您在線上舉辦更棒的對話。這個 API 採用機器學習技術 (ML) 來分析文字字串，並預測對對話可能造成的影響。

在這個程式碼研究室中，您設定了 Perspective API。

課程內容

  • 採用 AI 技術的審核機制，可在內容建立時立即標記內容。

軟硬體需求

2. 開始使用

首先，您需要 Google Cloud 專案來驗證 API 要求。

  1. 在 Google Cloud Console 中使用現有專案。
  2. 如有需要，請按照下列步驟建立新專案：
  • 登入 Google 帳戶。
  • 開啟 Cloud Console。
  • 按一下 [Create Project] 或開啟 [Select a Project] 選單，然後按一下對話方塊中的 [New Project]。
  • 為專案命名，然後按一下 [Create]。

ba7a5088d7d0047e.png

現在該專案會顯示在下拉式選單中。

要求 API 存取權

你應該會在一小時內收到一封電子郵件，確認你可以在 Google Cloud 中查看及啟用這個 API。

3. 啟用 API

  • 在 Cloud Console 中，前往「Perspective API 總覽」頁面，然後按一下 [啟用]。

4. 產生 API 金鑰

  1. 在導覽選單中，按一下 [APIs & Services > Credentials > Create credentials > API Key]。

8ab64b6d9822c219.png

您的 API 金鑰應該在幾分鐘內就能完成，但最多也可能需要一個小時。在此之前，您可能會收到錯誤訊息。

  1. 複製 API 金鑰。

43fb6b1cf99a4e16.png

5. 範例要求

您可以使用 Google API 用戶端程式庫產生 API 用戶端程式庫。以下範例說明如何使用一些常用語言來設定 API 程式庫。

  1. 發出 AnalyzeComment 要求。
  2. 執行其中一種 API 呼叫範例，直接從 Perspective API 取得分數。

AnalyzeComment 方法會發出 API 要求來分析 requestedAttributes 的 comment.text 欄位 (這裡是指 TOXICITY 模型)。

  1. 將 API 金鑰貼到 API_KEY 欄位中。

如有需要，您可以使用 doNotStore 標記，確保所有傳回的註解都會在分數傳回後自動刪除。

  1. 請參閱 API 參考說明文件，進一步瞭解所有要求和回應欄位，以及 requestedAttributes 的可用值。

您還可以使用實驗屬性，例如 OBSCENE、ATTACK_ON_COMMENTER 和 SPAM。

Python

這個範例要求和回應使用 Python 版本的 Google API 用戶端程式庫。

  1. 安裝 Python 用戶端程式庫。
  2. 執行下列指令：

ad3fa8068f953ae9.png

您應該會看到如下輸出結果：

961ee26edcfd6cd0.png

親切的問候語有低惡意指數。

Node.js

這個範例要求和回應使用的是 Node.js 版本的 Google API 用戶端程式庫。

  1. 安裝 Node.js 用戶端程式庫或安裝 npm 套件 googleapis。
  2. 執行下列指令：

34c914e027ff0225.png

您應該會看到如下輸出結果：

d6a18c7233a51a77.png

cURL

此要求範例與回應使用 cURL 指令。這個指令適用於大多數的 MacOS 和 Linux 使用者。您可能需要安裝 cURL 才能執行此指令。

  • 然後將 YOUR_KEY_HERE 替換成您的 API 金鑰。

327f1e3f1faf92a8.png

在這個回應中，attributeScores.TOXICITY.summaryScore.value 欄位會給予評論模型的惡意分數。評論為 0.9 分，滿分 1.0 分。

1977c2bbb5343d93.png

6. 恭喜

您已順利執行 Perspective API！

瞭解詳情

  • Perspective API 網站提供有關 API 的詳細資訊，包括個案研究。
  • Perspective API 開發人員網站提供了屬性、語言和方法的詳細資訊。如果您想快速開始操作，請參閱方法頁面，瞭解如何使用 AnalyzeComment 和 SuggestCommentScore 方法。