Pangram 3.0 API 迁移指南

Pangram 3.0 API 现已上线！本指南涵盖了您从 v2 接口迁移至全新 v3 API 所需了解的所有内容。

v3 版本有哪些新功能？

我们为人工智能辅助生成的文本新增了第三类分类。属于这一类别的文本通常融合了大量的人工智能和人类的创作——这反映了当今人们实际使用人工智能工具的方式。

关键架构变更

v3 API 会为每个文档分配三个分数字段，用于表示文档中属于各类别的比例：

• fraction_human — 被归类为人工撰写的段落
• fraction_ai_assisted — 被归类为AI辅助的部分
• fraction_ai — 该部分被归类为AI生成内容

这三个领域互斥且互补；它们的总和始终等于1。

此外，每个文档都包含三条预测字符串，分别对应不同的详细程度：

• 标题 — 例如：“纯人工撰写”、“AI辅助”、“AI检测”
• 预测 — 分类的详细说明。例如，“我们确信该文档完全由人工智能生成”或“我们认为该文档虽有人工智能辅助，但并非完全由人工智能生成”。
• 预测_简短 — 例如，“人类”、“混血”、“AI”

窗口级分析

每个输入文档都被划分为若干窗口。每个窗口都标有：

• 标签 — 分类字符串（“人工生成”、“部分由AI辅助生成”、“AI生成”等）
• 信心 — Pangram 检测模型生成的置信度（“高”、“中”、“低”）
• ai_assistance_score — 0 到 1 之间的标量，表示 AI 辅助的强度

注：预计不久后将引入更多标签（如“轻度AI辅助”、“重度AI辅助”）。

---

我应该迁移吗？

如果您符合以下情况，请选择“是”：

• 在生产环境中使用 Pangram 的结果
• 希望提高最新AI模型的输出准确率
• 计划在2026年4月1日之后继续使用Pangram API

如果以下情况适用，请选择“否”：

• 您是一位需要静态 API 来确保结果可重复性的研究人员

---

时间轴

---

V2 端点（有效期至 2026 年 4 月 1 日）

在过渡期间，以下 v2 端点仍可使用：

• text.api.pangram.com
• text-batch.api.pangram.com
• text-sliding.api.pangram.com
• text-extended.api.pangram.com
• dashboard-text.api.pangram.com

---

现场迁移指南

来自 text.api.pangram.com

目标： https://text.api.pangram.com → https://text.api.pangram.com/v3

若要全面了解 Pangram 的预测，请使用顶级字段：

匹配原始端点的行为：原始端点仅使用文本的第一个窗口进行预测。要匹配此行为：

重要提示： 对……的解释 ai_assistance_score 不同于 ai_likelihood. 这些字段并非一一对应。预计中间区间（0–1）的预测结果会更多。使用 标签 以了解我们建议的解读。

---

来自 text-batch.api.pangram.com

目前 v3 API 没有批量处理的终点。请使用循环逐个处理每个项目，具体方法如下： text.api.pangram.com 上方的迁移指南。

---

来自 text-sliding.api.pangram.com

目标： https://text-sliding.api.pangram.com → https://text.api.pangram.com/v3

窗口更改：

• 在 文本滑动, 窗口是 重叠
• 在 v3 中，窗口不会重叠

---

来自 text-extended.api.pangram.com

目标： https://text-extended.api.pangram.com → https://text.api.pangram.com/v3

大多数字段保持不变：

已更改的字段：

---

文档

完整的 API 文档请参见此处。

---

有问题吗？

如果您对迁移至 v3 有任何疑问，请发送邮件至support@pangram.com 联系我们。