跳至正文
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_TW",
  "mode": "reduce-aigc"
}
多接口示例
JSON
POST /api/v1/detect
{
  "text": "需要檢查的文字",
  "language": "zh_TW",
  "source_kind": "paste"
}

下一步

快速開始

完成第一次请求。

認證

查看金鑰处理方式。

更新日誌

查看近期平台变更。

下一步，把它接到你的工作流程。繼續閱讀