浏览文档

TurnitPass API 文档

从 API 密钥开始，调用拟人改写、改写润色、AI 检测、文献引用和参考文献端点，把 TurnitPass 接入你的写作产品。

REST API v1

一次请求

快速示例

使用 Bearer API 密钥向改写接口提交文本。响应返回改写结果、已用字数，以及密钥所属账户的剩余字数。

curl

POST /api/v1/humanize

1curl -X POST https://turnitpass.com/api/v1/humanize \
2  -H "Authorization: Bearer tp_live_your_api_key" \
3  -H "Content-Type: application/json" \
4  -d '{"text":"Paste your draft here","language":"en","mode":"revise"}'

response

200 OK

1{
2  "output": "Your humanized text...",
3  "words_used": 6,
4  "words_remaining": 249994
5}

同一套密钥流程也覆盖润色、重写、检测、引用、参考文献和状态查询接口。

文档地图

浏览文档

快速开始

在工作台创建 API 密钥，然后用同一个 Bearer 令牌调用改写、AI 检测和引用接口。

认证

开发者请求使用 TurnitPass 工作台生成的 API 密钥。

API 参考

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

更新日志

拟人改写、AI 检测、写作工具、账单和 API 的近期变化。

发起第一次拟人改写请求

创建密钥并发送第一次请求。

TurnitPass REST API

查看接口、参数、限额与响应结构。

下一步

请求流程

每次 TurnitPass API 调用都走同一路径：认证密钥、校验载荷、执行写作或引用流程、计量用量，并返回可供产品存储的响应结构。

认证 API 密钥

使用工作台生成的密钥。已撤销、格式错误或缺失的密钥会在处理文本前失败。

校验文本、语言和限额

改写请求执行字数范围，检测请求执行更长扫描限额，引用请求校验样式与来源。

执行流程

改写、润色、重写、检测、引用和参考文献路由复用与公开工具相同的服务端行为。

记录用量并返回结果

成功调用返回结果及用量元数据：已用字数、剩余余额、状态，或格式化的引用导出。

API Surface

Core endpoints

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.

上线清单

服务端调用

切勿把密钥暴露在客户端包中从后端、worker、队列或受保护的服务端操作调用 TurnitPass。

重试策略

只重试网络失败，不重试校验失败将 4xx 视为用户或载荷问题；仅对短暂的 5xx/网络错误重试。

字数预算

大批量前先查看剩余额度用状态接口决定排队、引导升级，或拆分文档。

账单配置

Stripe 密钥属于最终配置结账、门户和 webhook 已接通；线上密钥与价格 ID 在部署时填入。

产品接入应为每个环境单独准备一把密钥。生产、预发与本地应可独立撤销。

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