Perspective API 文档

Perspective 是一款免费的 API，旨在帮助您在线上营造更健康的对话环境。该 API 使用机器学习模型来评估一条评论可能对对话产生的潜在影响，并给出相应的评分。您可以利用这一评分向发帖者提供反馈、协助版主更高效地审核评论、帮助读者更容易找到有趣或富有建设性的内容，以及其他多种用途。

Perspective 由 Jigsaw 和 Google 反滥用技术团队在名为 Conversation-AI 的合作研究项目中开发。如需了解更多关于该 API 的信息，请访问 PerspectiveAPI.com。有关开发者文档及入门指南，请前往我们的开发者网站：Developers.PerspectiveAPI.com。如果您未能找到所需答案，欢迎 联系我们。

此外，您还可以查看 我们的其他仓库，其中包含开源实验、工具和研究数据，用于探索应对网络毒性与骚扰的方法。

Perspective API 遵循 Google 隐私政策 和 Google API 服务条款 提供。

Perspective API 快速上手指南

Perspective API 是由 Jigsaw 和 Google 团队开发的免费 API，利用机器学习模型对评论的“感知影响力”进行评分，帮助开发者识别网络毒性内容、辅助审核及优化社区互动。

环境准备

在开始之前，请确保满足以下要求：

• 操作系统：支持 Linux、macOS 或 Windows。
• 编程语言：支持多种语言（Python, Node.js, Java, Go 等），本指南以 Python 为例。
• 前置依赖：
  • Python 3.6+
  • pip 包管理工具
  • API 密钥：访问 Developers.PerspectiveAPI.com 注册账号并获取 API Key。
• 网络提示：由于服务由 Google 提供，中国大陆地区开发者可能需要配置代理或使用加速工具才能正常连接 API 端点。

安装步骤

推荐使用官方提供的 Python 客户端库进行开发。请在终端执行以下命令安装：

pip install google-cloud-language
# 或者安装专门的 perspective-api 包装库（如有社区维护版本）
# pip install perspective-api-client

注：官方核心功能通常通过直接调用 REST API 或使用 Google Cloud 通用库实现。若使用纯 HTTP 请求，无需额外安装特定库，仅需 requests 库：

pip install requests

基本使用

以下是最简单的 Python 示例，展示如何发送文本并获取毒性评分（TOXICITY）。

1. 将下方代码保存为 main.py。
2. 将 <YOUR_API_KEY> 替换为你申请的真实密钥。
3. 运行脚本。

import requests
import json

API_KEY = "<YOUR_API_KEY>"
URL = f"https://commentanalyzer.googleapis.com/v1alpha1/comments:analyze?key={API_KEY}"

data = {
    "comment": {"text": "你是个傻瓜"},
    "languages": ["zh"],
    "requestedAttributes": {"TOXICITY": {}}
}

headers = {
    "Content-Type": "application/json"
}

response = requests.post(URL, headers=headers, data=json.dumps(data))
result = response.json()

# 输出毒性评分 (0.0 - 1.0)
toxicity_score = result["attributeScores"]["TOXICITY"]["summaryScore"]["value"]
print(f"毒性评分：{toxicity_score}")

if toxicity_score > 0.8:
    print("检测到高毒性内容，建议拦截或审核。")
else:
    print("内容安全。")

响应说明：

• value 范围在 0.0 到 1.0 之间，数值越高表示该评论被感知为具有攻击性或毒性的可能性越大。
• 你可以根据业务需求设定阈值（如 0.8）来自动过滤或标记评论。