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 多种语言
英语使用经过微调的人性化引擎。传入语言值后，请求会改为路由到多语言路径，因此非英语产品页面也能访问同一端点，无需第二次集成。
语体和强度是参数
五种写作模式覆盖 Academic、Corporate、Creative、Blog/SEO 和 General 语体。intensityScalar 值决定改写与原文的差异程度，可取 0、0.25、0.5、0.75 或 1，范围从 Mild，经由 0.5 处的 Balanced 默认值，到 Aggressive。
每篇文档一次 POST
无需轮询任务队列，也无需注册 webhook。humanize 调用会保持连接，直到模型返回并给出改写文本，因此一次请求即可完成工作。
重试不会重复计费
发送一个 requestId，结果会在其上缓存约 10 分钟。在该时间窗口内再次使用相同标识符，会直接重放已存储的响应，而不是再次运行模型。任何引擎未能完成的请求，其输出文本会自动退回到你的余额中。
端点参考
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 之一。改写与原文的距离，从 Mild 到 Balanced 再到 Aggressive。 |
language | string | 可选 | 将非英语文本路由到多语言路径。若省略，或发送英语文本，则使用经过微调的英语引擎。 |
englishVariant | string | 可选 | 美式或英式。将拼写和词汇限定在大西洋一侧。 |
freezeTerms | string[] | 可选 | 最多 10 个在改写过程中逐字保留的术语或短语：构造名称、仪器、产品名称。 |
removeEmDashes | boolean | 可选 | 将 em dash 结构改写为常规标点。 |
requestId | string | 推荐 | 你的幂等令牌。在大约十分钟内重复使用它，会重放已存储的响应，而不会再次计费。 |
响应字段
outputTexthumanized 后的文本。metrics.inputWords / outputWords接收的词数和返回的词数。改写后的长度通常会比原文略长。metrics.wordsCharged本次调用的费用。始终等于输入词数，而不是输出词数。metrics.balanceRemaining本次调用后该密钥剩余的词数额度，因此你可以在不发起第二次请求的情况下进行计量。metrics.modelLatencyMs / route改写所用的引擎时间，以及提供服务的路径。错误与重试
每个错误都会返回带有稳定 error.code 和可读消息的 JSON。值得围绕其进行设计的规则是：你只会为已交付的改写付费，并且使用相同 requestId 重试始终是安全的。
UNAUTHORIZEDAPI key 缺失或无法识别。请检查 Authorization: Bearer 头。INSUFFICIENT_BALANCE该密钥上的词数额度不足。响应会包含可用余额。REQUEST_IN_PROGRESS带有此 requestId 的请求仍在处理中。请等待它完成，而不是与之并行抢跑。TOO_LONG / VALIDATION_FAILED输入超出 1,000 词上限，或某个参数格式不正确。响应会列出具体问题。ENGINE_ERROR引擎失败或超时。字数已退回到您的余额中，请使用相同的 requestId 重试。端点背后的引擎
每次调用都运行已发布的 TextPulse 引擎，在 2,000 篇文档的学术语料库上进行测量，并在检测模型更新时重新运行。按检测器划分的低分率：
由供应商基于其语料测得的数据。随其语料发布。任何 humanizer 都无法承诺对特定文档的检测结果，因此在产品信息传达中以测量为依据，而不是以保证为依据。
团队基于 humanizer API 构建的内容
EdTech 和写作平台
在您现有的语法或改写功能旁添加一个 humanize 操作。Academic 模式会保留引文完整，因此面向学生的工具在发送文本前无需删除参考文献。
文档和校对工具
将整篇文档按 1,000 词分块传输并重新组装。Freeze terms 可在各个分块之间保持名称和术语稳定，而幂等重试使批处理流水线可以安全地重新运行。
内容和 SEO 产品
Blog/SEO 模式会将草稿改写为可发布的散文，而 freeze terms 会锁定目标关键词，因此文案既保留搜索意图，又失去机器式节奏。
白标合作伙伴
该端点会无缝运行在您的产品内部, 您的界面, 您的计费, 我们的引擎。合作方案会根据月度用量通过访问表单报价。
AI 人性化 API 定价
积分预付并按字数扣减。计费统计你发送的内容，而不是引擎返回的内容。任何未能生成改写的调用都会退回到对应的积分键。
积分自购买之日起有效期为 12 个月，涵盖该端点支持的所有语言、写作模式和英语变体。对于持续的大批量使用，或在您自己的产品中采用白标方案，申请访问，我们将根据您的月度用量报价。
获取您的 API 密钥
密钥按项目发放。请描述您正在构建的内容，我们会在 24 小时内回复。