跳至正文
TurnitPass
开发者中心API v1
管理密钥
浏览文档

开发者API 参考

TurnitPass REST API

拟人改写、改写润色、AI 检测、文献引用、参考文献和 API 密钥状态端点参考。

REST API v1

参考控制台

先看路由、载荷和响应结构。

完整参考覆盖下方全部接口。控制台先展示开发者需要的约定：Bearer 认证、JSON 输入、按量输出和状态查询。

request
POST
fetch('/api/v1/humanize', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tp_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text: 'Paste the draft here',
    language: 'en',
    mode: 'reduce-aigc'
  })
})
response
200 OK
{
  "output": "The revised text...",
  "words_used": 142,
  "words_remaining": 2858,
  "status": "succeeded"
}
按量计量已记录JSON
POST/api/v1/humanize
POST/api/v1/paraphrase
POST/api/v1/detect
POST/api/v1/citation
GET/api/v1/status
认证Bearer API 密钥
改写POST /humanize
审阅POST /detect
状态GET /status
POST/api/v1/humanize
v1

降低提交文本中的 AI 痕迹。支持 reduce-aigc、reduce-both、paraphrase、academic-polish 等模式。

POST/api/v1/paraphrase
v1

按标准、流畅、正式、学术、简洁、创意、扩写或缩写模式改写文本。

POST/api/v1/detect
v1

为粘贴文本或解析后的文档返回分数、风险等级、元数据和 AI 写作信号。

POST/api/v1/citation
v1

将 DOI、URL 或手动来源格式化为 APA、MLA、Chicago、IEEE、Harvard、GB/T 等格式。

GET/api/v1/status
v1

查看密钥名称、剩余字数和请求限制。

参数与选项

认证
Authorization: Bearer tp_live_...
保留术语
可选 personal_terms 用于在英文拟人改写中保留专有名词、技术术语和品牌写法。

速率限制与请求限额

改写输入
单次处理长度拟人和学术改写：500 中文字或 1,500 英文字符。润色：2,000 中文字或 6,000 英文字符。混排共用处理长度，计费按实际字词数；所有套餐一致。
检测输入
最多 5,000 字更长的检测文本应在提交前分段。
API 密钥
最多 5 个有效密钥可在工作台独立撤销。
引用工具
单独限流引用和参考文献调用不消耗字数。

错误处理

错误响应使用 JSON，并在可能时包含 error、code 和可读的 message 字段。

error response
JSON
{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}
Stripe 与 Google 凭证属于配置项。接口、认证流程和持久化已实现，接入线上凭证无需重新设计产品。

示例

改写示例
JSON
POST /api/v1/humanize
{
  "text": "请把这段 AI 草稿改得更自然。",
  "language": "zh_CN",
  "mode": "reduce-aigc"
}
多接口示例
JSON
POST /api/v1/detect
{
  "text": "需要检查的文本",
  "language": "zh_CN",
  "source_kind": "paste"
}

下一步

快速开始

完成第一次请求。

认证

查看密钥处理方式。

更新日志

查看近期平台变更。

下一步，把它接到你的工作流。继续阅读