Pangram 3.0 API 迁移指南

Pangram 3.0 API 已正式上线！本指南详尽介绍了从 v2 接口迁移至全新 v3 API 的所有必要步骤。

v3版本新增了什么？

我们为人工智能辅助文本新增了第三类分类。此类文本通常融合了大量人工智能与人类的创作输入，真实反映了当今人们使用人工智能工具的实际情况。

关键架构变更

v3 API 通过三个分数字段对每个文档进行分类，这些字段分别表示文档中属于各类别的比例：

• 人类碎片 — 人类撰写部分
• fraction_ai_辅助 — 部分内容被归类为AI辅助生成
• 分数AI — 部分内容被归类为AI生成

这三个选项互斥且互补，其总和始终等于1。

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

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

窗口级分析

每个输入文档被分割为多个窗口。每个窗口都标有：

• 标签 — 分类字符串（'人类创作'、'人工智能辅助创作'、'人工智能生成'等）
• 自信 — Pangram检测模型的置信度输出（'高'，'中'，'低'）
• AI辅助评分 — 表示AI辅助程度的0到1之间的标量

注：预计近期将引入更多标签（如"轻度AI辅助"、"重度AI辅助"）。

---

我该迁移吗？

是，如果你：

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

如果以下情况，请选择"否"：

• 是一位需要静态API来实现可重复性的研究人员

---

时间线

日期	活动
2025年12月11日	Pangram 3.0 通过控制面板发布
2025年12月23日	Pangram 3.0 现已通过 API 提供
2026年1月下旬	Pangram 3.1 版本发布（仪表盘 + API）。所有 3.0 API 用户已自动升级。
2026年4月1日	Pangram 2.0 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
• 仪表盘文本.api.全字母句.com

---

字段迁移指南

自 text.api.pangram.com

终点： https://text.api.pangram.com → https://text.api.pangram.com/v3

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

v2 字段	v3 字段	注释
预测	标题	诸如"完全人工撰写"、"AI辅助"、"AI检测"等标识
ai_likelihood	分数AI	据信由人工智能生成的文本数量
—	fraction_ai_辅助	新消息：据信该数量由人工智能辅助生成
—	人类碎片	据信为人工书写的内容量

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

v2 字段	v3 字段
预测	windows[0].label 以及 windows[0].置信度
ai_likelihood	windows[0].人工智能辅助评分

重要提示： 对……的解释 AI辅助评分 不同于 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

v2 字段	v3 字段	注释
预测	标题 或 预测	提供不同详细程度的选项
预测_简短	预测_简短	不变
ai_likelihood, 平均AI似然值	分数AI, fraction_ai_辅助, 人类碎片	使用数量字段代替聚合置信度评分
最大人工智能似然值	分数AI （推荐）	数量字段优先

窗口变化：

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

v2 窗口字段	v3 窗口字段
windows[].预测	windows[].label + windows[].置信度
windows[].ai_likelihood	windows[].ai_assistance_score

---

自 text-extended.api.pangram.com

终点： https://text-extended.api.pangram.com → https://text.api.pangram.com/v3

大多数字段保持不变：

领域	状态
标题	不变
预测	不变
预测_简短	不变
人类碎片	不变
分数AI	不变
windows[].label	不变
windows[].置信度	不变
windows[].start_index	不变
windows[].end_index	不变

已更改的字段：

v2 字段	v3 字段	注释
分数混合	fraction_ai_辅助	为明确起见，字段已重命名
仪表盘	公共仪表板链接	为明确起见，字段已重命名
平均AI似然值	分数AI, fraction_ai_辅助, 人类碎片	使用数量字段代替聚合置信度评分
最大人工智能似然值	分数AI, fraction_ai_辅助, 人类碎片	使用数量字段代替聚合置信度评分
windows[].ai_likelihood	windows[].ai_assistance_score	AI可能性评分与AI辅助评分并非一一对应。使用 标签 供参考。

---

文档

完整的API文档可在此处获取。

---

有问题吗？

若您对迁移至v3版本有任何疑问，请通过support@pangram.com联系我们。