浏览文档

发起第一次拟人改写请求

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

REST API v1

五分钟路径

从空工作台到第一篇改写稿。

顺序与公开产品一致：开通访问、确认额度、签发密钥，再从服务端调用写作接口。

接入路径

需要先完成的步骤

4 步

创建工作台

使用 Google 登录即可打开个人 API 控制台。

补充字数

结账与门户钩子已就绪，等待填入 Stripe 密钥。

生成密钥

复制一次，并保存在服务端。

调用 /humanize

提交文本，获得按量计量的结果。

服务端请求

改写接口

v1 可用

request

POST

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 '{
5    "text": "Paste the AI-assisted draft you want to revise",
6    "language": "en",
7    "mode": "reduce-aigc"
8  }'

response

200 OK

1{
2  "output": "The revised text...",
3  "words_used": 142,
4  "words_remaining": 2858
5}

下一次调用

如需继续检查改写结果或整理引用，可接着调用检测或引用接口。

查看示例

五分钟内完成

准备

创建账户

使用 Google 登录，打开工作台管理账单、密钥、用量和字数余额。

选择方案或字数额度

Stripe 结账与客户门户已接通。线上商品密钥与价格在最终配置时填入。

创建 API 密钥

在工作台生成密钥，立即复制，并以 Bearer 令牌发送。

发送第一次请求

用下方示例调用改写接口，并查看响应结构。

第一次 API 调用

将 tp_live_your_api_key 替换为工作台生成的密钥。请求应从服务端发出，而不是浏览器。

改写请求

curl

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":"请把这段 AI 草稿改得更自然。","language":"zh_CN","mode":"reduce-aigc"}'

润色请求

curl

1curl -X POST https://turnitpass.com/api/v1/paraphrase \
2  -H "Authorization: Bearer tp_live_your_api_key" \
3  -H "Content-Type: application/json" \
4  -d '{"text":"请把这段话改得更清楚、更适合提交。","mode":"academic"}'

响应

response

200 OK

1{
2  "output": "The humanized version of your text...",
3  "words_used": 8,
4  "words_remaining": 249992
5}

失败的改写请求返回结构化 JSON 错误。校验或引擎失败不扣减字数。

第一次调用之后

流程示例

多数接入会组合多个 TurnitPass 能力。可在改写前后调用检测，并在需要结构化来源时使用引用和参考文献。

检测请求

POST /api/v1/detect

1curl -X POST https://turnitpass.com/api/v1/detect \
2  -H "Authorization: Bearer tp_live_your_api_key" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "text": "Paste at least 50 words of writing to scan.",
6    "language": "en",
7    "source_kind": "paste"
8  }'

引用请求

POST /api/v1/citation

1curl -X POST https://turnitpass.com/api/v1/citation \
2  -H "Authorization: Bearer tp_live_your_api_key" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "input": "https://example.com/research-article",
6    "style": "apa"
7  }'

引用和参考文献响应包含格式化文本，以及可用的 BibTeX、RIS 等导出格式。

下一步

使用 Bearer API 密钥认证

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

TurnitPass REST API

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

认证

密钥安全、存储与错误处理。

API 参考

参数、速率限制与接口示例。

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