Pangram 4 迁移指南

Pangram 4 迁移指南

Pangram 4 现已在我们的 API 中上线。

由于计费系统进行了部分更新，Pangram 3.3.2 目前仍是默认版本，并将持续运行至2026 年 9 月 30 日。

本指南涵盖了您在迁移至 Pangram 4 时需要了解的所有内容。

Pangram 4 有哪些新功能？

Pangram 4 引入了更精准的检测模型、基于分段的人类化检测，以及一套简化的分类标签。更多详情请参阅Pangram 4 模型卡片！

响应结构总体上依然熟悉，因此大多数集成只需进行少量修改即可：

• 请明确使用以下方式请求 Pangram 4： 模型："pangram-4"
• 更新至版本 1.0.0 Python SDK 的
• 支持新版 Pangram 4 窗口标签
• 可选地使用新的“人性化”字段
• 更新后的 API 计费表的说明

“全字母句”第4期也回归了：

{
  "version": "4.0"
}

我应该迁移吗？

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

• 想在 Pangram 4 成为默认选项之前就开始使用它吗？
• 在应用程序或生产工作流中使用窗口标签
• 想要访问新的“人性化”字段吗
• 需要在9月30日之前留出时间测试您的集成
• 想使用您通常的请求规模来评估更新后的计费模式吗

如果您符合以下情况，则“尚未”：

• 需要在预发布环境中额外花些时间来验证“Pangram 4”
• 依赖于Pangram 3.3.2的具体标签字符串，且尚未更新您的集成
• 需要评估按每100词计费的方式将如何影响您的使用情况

Pangram 3.3.2 仍是默认版本，并将持续运行至 2026 年 9 月 30 日。

时间轴

我们建议您在 9 月 30 日之前测试 Pangram 4，特别是如果您的集成在确切的窗口标签字符串上存在分支情况。

REST API 迁移

对于使用 REST API 的用户，请发送一个 POST 请求发送至：

https://text.external-api.pangram.com/task

请求正文现在应包含：

{
  "text": "...",
  "model": "pangram-4"
}

由于在过渡期间 Pangram 3.3.2 仍是默认版本，因此您必须明确请求使用 Pangram 4。

请求示例

curl --request POST \
  --url https://text.external-api.pangram.com/task \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data '{
    "text": "Your text goes here.",
    "model": "pangram-4"
  }'

Python SDK 迁移

对于使用 Python SDK 的用户，请更新至 v1.0：

pip 安装 --upgrade pangram-sdk==1.0.0

然后显式地请求 Pangram 4：

来源 全字母句 import Pangram

client = 全字母句()

结果 = client.预测(
    text,
    模型="pangram-4",
)

与 REST API 一样，在过渡期间必须明确选择 Pangram 4。

响应模式变更

整体的答题结构依然熟悉，每个“全字母句”4中增加了两项内容 windows[] 项目：

“全字母句”第4期也回归了：

{
  "version": "4.0"
}

窗口标签迁移

唯一可能导致兼容性问题的变更在于，Pangram 4 的窗口标签现为：

• AI生成
• AI辅助
• 由人工撰写

AI辅助 取代之前的 轻度AI辅助 以及 适度采用人工智能辅助 标签。

如果您的集成是根据精确的标签字符串进行分支的，请在迁移前对其进行更新。

例如，之前将这两个AI辅助标签分别处理的代码：

if window["label"] in {
    "Lightly AI-Assisted",
    "Moderately AI-Assisted",
}:
    handle_ai_assisted(window)

应更新为：

如果 window["标签"] == "AI辅助":
    handle_ai_assisted(window)

一个完整的 Pangram 4 标签处理程序可能如下所示：

标签 = window["标签"]

如果 标签 == "AI生成":
    handle_ai_generated(window)
elif 标签 == "AI辅助":
    handle_ai_assisted(window)
elif 标签 == "人工撰写":
    handle_human_written(window)
else:
    处理未知标签(window)

我们建议保留“未知标签”的备用方案，而不是假设 API 总会返回当前文档中列出的某个字符串。

现场迁移指南

在向 Pangram 4 迁移时，大多数 Pangram 3.3.2 的响应字段无需进行更改。

主要兼容性问题在于 windows[].label. 此前两个由人工智能辅助的类别现已合并为一个 AI辅助 标签。

账单变更

最后提醒一下：我们将更新 API 的计费方式。

我们正在提高使用量计费的精细度。今后，请求将按每100个单词计费，而非每1,000个单词。这对许多用户来说将是一项利好。

不过要提前说明一下，Pangram 4 是一款体积更大、功能更强大的机型，因此我们不得不提高其售价。

请查看价格页面，了解最新价格信息！

在将所有生产流量迁移至 Pangram 4 之前，请根据您应用程序的典型请求长度和请求量，对更新后的计费模式进行审核。

推荐的迁移流程

1. 更新您的客户端

REST API 用户可以继续使用现有的任务端点。

Python SDK 用户应安装该版本 1.0.0:

pip 安装 --upgrade pangram-sdk==1.0.0

2. 明确请求“全字母句”4

在每个请求中添加模型参数：

{
  "model": "pangram-4"
}

3. 更新精确标签比较

替换以下检查：

轻度AI辅助
中度AI辅助

主演：

AI辅助

此外，请确认您的集成支持以下四个确切的 Pangram 标签：

AI生成
AI辅助
人工撰写

4. 支持新领域

更新响应类型、验证模式、数据库模型和分析管道，以支持：

windows[].is_humanized
windows[].humanizer_score
version

如果您的应用程序尚未使用人性化分析，则最初可将新窗口字段视为可选字段。

5. 审查计费假设

今后，请求将按每100词计费，而非按每1,000词计费。

使用具有代表性的生产流量测试效果。

迁移检查清单

• 将 Python SDK 更新为 pangram-sdk==1.0.0，如适用
• 添加 模型："pangram-4" 针对 API 请求
• 消除对以下内容的依赖： 轻度AI辅助
• 消除对以下内容的依赖： 适度采用人工智能辅助
• 支持 AI辅助
• 添加对以下内容的支持： windows[].is_humanized
• 添加对以下内容的支持： windows[].humanizer_score
• 请确认响应版本为 "4.0"
• 审查新的每100词计费标准
• 请在2026年9月30日之前测试迁移过程

有问题吗？

很高兴大家开始使用 Pangram 4 了。如有任何问题，请随时联系我们。未来几天我们将格外及时地回复大家！

如需迁移支持，请联系support@pangram.com。