> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/chinese-simplified/api-wen-dang-liao-tian.md).

# API 文档：聊天

## **简介**

GGWP 提供了一个 API，您可以用它来处理聊天数据，并将操作集成到您的聊天应用工作流中。该产品旨在识别消息级别的相关事件，同时跟踪整个对话的演变以及每个单独用户的贡献。GGWP 可以检测事件（正面和负面）、分析对话热度，并生成用户信誉评分，等等。

## 入门指南

在开始使用 API 之前，了解该产品的工作方式非常重要，这样才能充分发挥其全部潜力。

### **了解 GGWP 的聊天审核**

GGWP 的聊天审核服务涵盖 3 个用例：

* 实时内容过滤 - 该 API 允许您为严重程度和主题选择创建自定义设置，以便您可以阻止在您的特定社区中想要防止的内容类型。
* 对话分析 - 旨在结合对话中的上下文元素以及 GGWP 的用户信誉系统，为您提供会话中正面和负面事件的累计视图。这可以与客户端上的不同类型的警告或提醒集成。
* 自动审核服务 - 允许您通过静音、暂停和封禁来自动惩罚有毒玩家，从而让违规玩家有足够时间冷静下来，并防止对其他玩家造成进一步影响。该系统会考虑事件严重程度、检测置信度以及玩家历史和会话行为，以确定何时以及惩罚玩家多长时间。

您将针对每条单独消息或消息块进行 1 次 API 调用，其中包括用于识别发送者和会话的一些基本信息（更多信息请参见下方“聊天 API”部分）。GGWP 会处理所有步骤，以提供相关洞察。

响应返回给您后，我们建议集成不同的操作以改善您平台上的用户体验。一些示例操作包括用我们的过滤版本替换原始消息、向用户发送警告或静音最具破坏性的参与者。

### **可配置设置**

可以定义自定义设置，以选择您希望在平台中防止的内容类型。这可以通过 2 种方式完成：

* 在入驻时（推荐）- 您将所需配置与您的客户经理共享，GGWP 会将它们纳入您的特定 API 设置中。
* 在每次 API 调用期间 - 通过使用请求头，您也可以在每次发起 API 调用时输入一些自定义设置（详情请参见“聊天 API”部分）。这有一些限制，因为并非所有自定义元素都可以提供，而且更容易出错。

此外，如果您希望启用 GGWP 的自动审核服务，请联系您的 GGWP 客户经理。

以下是可配置内容的列表：

* **主题**：可用主题包括暴力、性内容、言语辱骂、身份仇恨、脏话、链接分享、毒品、垃圾信息和自残。
* **过滤强度**：聊天 API 中的过滤强度配置基于一个“安全”主视角。每个主题通常可以选择 4 个值，少数情况除外。这 4 个值是：
  * 过滤强度 = “关闭” - 过滤器不生效，因此允许所有形式的毒性内容。适用于面向成人且不希望施加任何限制的环境。
  * 过滤强度 = “低” - 仅过滤极端冒犯性内容，但允许中度和轻度毒性内容通过。适用于仅面向成人的环境。
  * 过滤强度 = “中” - 过滤掉极端和中度毒性内容，仅允许轻度毒性内容通过。适用于面向青少年的环境，其中可以容忍一些无害的毒性内容。
  * 过滤强度 = “高” - 过滤掉所有形式的毒性内容。适用于有儿童在场的环境。
* **自定义内容：** 如果您有想要纳入设置的自定义允许列表、黑名单或替换短语列表（用于替换有毒消息的短语），请联系您的 GGWP 客户经理，与我们共享这些文件。

### **语言支持**

GGWP 的聊天审核服务支持以下语言： 

* 阿拉伯语
* 中文（简体和繁体）
* 荷兰语
* 英语
* 菲律宾语（塔加洛语）
* 芬兰语
* 法语
* 德语
* 希腊语
* 希伯来语
* 印地语
* 印度尼西亚语
* 意大利语
* 日语
* 韩语
* 波斯语
* 波兰语
* 葡萄牙语
* 俄语
* 西班牙语
* 泰语
* 土耳其语
* 越南语

我们会定期添加新语言。请联系您的客户经理，了解即将支持的语言，或提交其他语言供考虑。

### **模型支持**

GGWP 的聊天审核涵盖的类别在以下部分中描述 [模型术语表部分](/chinese-simplified/wen-ben-yu-yu-yin-mo-xing-shu-yu-biao.md).