AI Humanizer API
通过一次 REST 调用，在你自己的产品中人性化 AI 文本。AI 人性化 API 将驱动 TextPulse 的引擎开放给你的后端，JSON 传入，改写后的散文返回，支持 60 多种语言。
发起你的第一次请求
使用 Authorization: Bearer 标头进行身份验证，然后提交你的文本。改写后的版本会以 outputText 返回，并附带该次调用的计量信息。
curl https://textpulse.ai/api/v1/humanize \ -H "Authorization: Bearer tp_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Our analysis indicates the intervention produced gains...", "writingMode": "Academic", "intensityScalar": 0.5 }'{ "outputText": "Our analysis points to measurable gains from the...", "metrics": { "inputWords": 128, "outputWords": 134, "wordsCharged": 128, "balanceRemaining": 99872, "modelLatencyMs": 4310, "route": "v1/humanize" }}AI 人性化 API 为你处理什么
语言路由、语体控制、计量和重试安全都包含在该端点中，因此你的集成始终只需一个函数。
一个路由覆盖 60 多种语言
英语使用经过微调的人性化引擎。传入语言值后，请求会改为路由到多语言路径，因此非英语产品页面也能访问同一端点，无需第二次集成。
语体和强度是参数
五种写作模式涵盖学术、企业、创意、博客/SEO和通用语域。intensityScalar 值用于设置改写与原文的差异程度，可取 0、0.25、0.5、0.75、1 或 1.25，范围从轻微，到默认的平衡 0.5，再到激进 1，直至 ULTRA 1.25。
每篇文档一次 POST
无需轮询任务队列，也无需注册 webhook。humanize 调用会保持连接，直到模型返回并给出改写文本，因此一次请求即可完成工作。
重试不会重复计费
发送一个 requestId，结果会在其上缓存约 10 分钟。在该时间窗口内再次使用相同标识符，会直接重放已存储的响应，而不是再次运行模型。任何引擎未能完成的请求，其输出文本会自动退回到你的余额中。
ULTRANEW!
ULTRA：通过 API 实现最高的 AI 分数降低
新的第六个强度设置在同一端点上运行。将 intensityScalar 设为 1.25 即可启用 ULTRA，这是人性化处理器的最大改写，GPTZero 评分降低率为 89%。
AI分数降低 vs. 语义忠实度 vs. 语法
- AI 分数降低（GPTZero，%）
- 语义忠实度（NLI 支持 × 100）
- 语法（LanguageTool 每 1,000 词标记数）
一个参数
将你已经发送的请求中的 intensityScalar 设为 1.25。端点、Bearer 密钥和 JSON 响应保持不变。
最大重写程度
ULTRA 会重写每个段落中比其他任何设置都更多的内容，以获得最高的 AI 评分降低，但代价是可读性和语法会略有下降。提交前请检查输出。
仅英文文本
ULTRA 仅适用于英文文本。其他五个设置覆盖 API 支持的所有语言。
按输入词数计费
ULTRA 请求按输入词数计费，与其他所有设置相同，且引擎未能完成的请求会自动将其词数退回到您的余额中。
端点参考
Authorization: Bearer 标头读取你的密钥。密钥以 tp_live_ 开头，并按项目发放。/api/v1/humanize/api/v1/balance一次 humanize 调用最多可接受 1,000 词，且字符上限为 10,000，每个密钥每分钟可发出 60 次请求。更长的文档会作为一系列调用发送。
请求参数
只需要 text。其他内容都有合理默认值，因此最小集成只需一个字段。
| 参数 | Type | 是否必填 | 说明 |
|---|---|---|---|
text | string | 必填 | 需要 humanize 的文本。每次请求最多 1,000 词，且不超过 10,000 个字符。 |
writingMode | string | 默认值：Academic | Academic、Corporate、Creative、Blog/SEO 或 General 之一。用于设定改写保持的语体。 |
intensityScalar | number | 默认值：0.5 | 0、0.25、0.5、0.75、1 或 1.25 之一。改写与原文的偏离程度，从轻微到平衡和激进，再到 ULTRA。ULTRA（1.25）仅适用于英文文本。 |
language | string | 可选 | 将非英语文本路由到多语言路径。若省略，或发送英语文本，则使用经过微调的英语引擎。 |
englishVariant | string | 可选 | 美式或英式。将拼写和词汇限定在大西洋一侧。 |
freezeTerms | string[] | 可选 | 最多 10 个在改写过程中逐字保留的术语或短语：构造名称、仪器、产品名称。 |
removeEmDashes | boolean | 可选 | 将 em dash 结构改写为常规标点。 |
requestId | string | 推荐 | 你的幂等令牌。在大约十分钟内重复使用它，会重放已存储的响应，而不会再次计费。 |
响应字段
outputTexthumanized 后的文本。metrics.inputWords / outputWords接收的词数和返回的词数。改写后的长度通常会比原文略长。metrics.wordsCharged本次调用的费用。始终等于输入词数，而不是输出词数。metrics.balanceRemaining本次调用后该密钥剩余的词数额度，因此你可以在不发起第二次请求的情况下进行计量。metrics.modelLatencyMs / route改写所用的引擎时间，以及提供服务的路径。keptLines按原样精确返回的标题、列表、表格、公式和参考文献。仅在文本包含此类行时出现。错误与重试
每个错误都会返回带有稳定 error.code 和可读消息的 JSON。值得围绕其进行设计的规则是：你只会为已交付的改写付费，并且使用相同 requestId 重试始终是安全的。
UNAUTHORIZEDAPI key 缺失或无法识别。请检查 Authorization: Bearer 头。INSUFFICIENT_BALANCE该密钥上的词数额度不足。响应会包含可用余额。REQUEST_IN_PROGRESS带有此 requestId 的请求仍在处理中。请等待它完成，而不是与之并行抢跑。TOO_LONG / VALIDATION_FAILED输入超出 1,000 词上限，或某个参数格式不正确。响应会列出具体问题。ENGINE_ERROR引擎失败或超时。字数已退回到您的余额中，请使用相同的 requestId 重试。INSUFFICIENT_PROSE文本中除标题、列表、表格、公式或参考文献外，正文段落不超过50词，可改写的内容太少。不会收取费用；请添加更多段落后重试。团队基于 humanizer API 构建的内容
EdTech 和写作平台
在您现有的语法或改写功能旁添加一个 humanize 操作。Academic 模式会保留引文完整，因此面向学生的工具在发送文本前无需删除参考文献。
文档和校对工具
将整篇文档按 1,000 词分块传输并重新组装。Freeze terms 可在各个分块之间保持名称和术语稳定，而幂等重试使批处理流水线可以安全地重新运行。
内容和 SEO 产品
Blog/SEO 模式会将草稿改写为可发布的散文，而 freeze terms 会锁定目标关键词，因此文案既保留搜索意图，又失去机器式节奏。
白标合作伙伴
该端点会无缝运行在您的产品内部, 您的界面, 您的计费, 我们的引擎。合作方案会根据月度用量通过访问表单报价。
AI 人性化 API 定价
积分预付并按字数扣减。计费统计你发送的内容，而不是引擎返回的内容。任何未能生成改写的调用都会退回到对应的积分键。
积分自购买之日起有效期为 12 个月，涵盖该端点支持的所有语言、写作模式和英语变体。对于持续的大批量使用，或在您自己的产品中采用白标方案，申请访问，我们将根据您的月度用量报价。
获取您的 API 密钥
密钥按项目发放。请描述您正在构建的内容，我们会在 24 小时内回复。