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

开发者开发者

把拟人改写与 AI 检测接入你的产品

查看 API 文档、创建密钥,了解身份认证、接口用法、用量与计费规则。

REST API v1

从你需要的流程开始

开发者中心

接入路径

创建密钥,调用接口,查看用量。

开发者路径与产品流程一致:密钥归属账户、请求按量计量、字数余额可见,文档对应线上路由。

01

创建 API 密钥

在工作台生成带名称的密钥,并只复制一次。

02

发送 Bearer 请求

调用改写、检测、润色、引用或参考文献接口。

03

查看用量

请求会汇总到字数余额、端点记录与账单限额。

v1
POST/humanizePOST/paraphrasePOST/detectPOST/citation
请求
POST /humanize
curl -X POST /api/v1/humanize
-H "Authorization: Bearer $KEY"

200 OK

响应

142

已用字数

2,858

剩余

工作台

密钥按账户隔离
计量账户用量
账单可接 Stripe
限额按套餐

默认仅本人可见

密钥经哈希存储,并归属当前账户。

API Surface

Core endpoints

需认证

Bearer API 密钥

按量计量

字数余额

可上线

账单接口

Revise

POST/api/v1/humanize

Revise AI-assisted text while preserving meaning.

Paraphrase

POST/api/v1/paraphrase

Rewrite and polish text in multiple modes.

Detect

POST/api/v1/detect

Return AI-writing signal estimates and revision notes.

Citations

POST/api/v1/citation

Format DOI, URL, or manual source metadata.

适用场景

常见接入场景

API 对应写作者在浏览器中使用的同一流程:改写、检测、润色、引用,并跟踪用量。

01POST /api/v1/humanize

内容平台

发布前对 AI 草稿做拟人改写,并在编辑器中展示检测反馈与引用整理。

02POST /api/v1/paraphrase

写作工具

在现有文档流程中加入改写、润色与 AIGC 检测,无需自建模型层。

03POST /api/v1/detect

审阅工作台

把提交内容送入检测接口,保存审阅说明,并向审阅者展示信号依据。

04POST /api/v1/citation

研究工作流

为文献密集产品、学生工具与学术写作助手格式化引用和参考文献。

上线细节

限额、账单与稳定性

面向真实用户开放 TurnitPass 前,客户端应按这些规则来设计。

认证

Bearer API 密钥

工作台 API 密钥创建时只显示一次,撤销后不影响 Google 登录。

改写限额

单次处理长度

拟人改写和学术改写:500 中文字或 1,500 英文字符。润色:2,000 中文字或 6,000 英文字符。混排共用处理长度,计费按实际字词数;所有套餐一致。

检测限额

5,000 字/次

检测支持更长输入,并返回估计、审阅说明与信号细节。

速率限制

50 次/分钟/密钥

改写、检测与状态接口默认每密钥每分钟 50 次;引用接口为 100 次。

账单路径

可接 Stripe

结账、门户、Webhook、字数余额与套餐限额已接通;线上密钥与价格 ID 可另行配置。

失败处理

成功才扣费

改写字数在引擎成功返回后扣减;校验失败或引擎错误不扣字数。

上线说明

账户访问控制. API 用量绑定到用户本人的密钥。请求数计入工作台用量,并支持限流、重试与未来团队权限控制。
集成账单系统. 在线结账、订阅状态同步、账单门户和套餐限制已完全支持,提供完整可靠的订阅流程。

上线前

上线清单

1

创建测试密钥

在工作台生成 API 密钥,并确认前缀只出现一次。

2

跑通核心调用

用同一 Bearer 令牌调用 humanize、detect、paraphrase、citation、bibliography 和 status。

3

处理错误

在客户端映射 invalid_api_key、rate_limited、insufficient_words 与校验错误。

4

配置账单

套餐与结账文案确定后,再填入 Stripe 密钥与价格 ID。

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