浏览文档

查看请求、字数、端点与剩余额度

TurnitPass 的用量按写作流程计量：改写、检测、引用，并在账户中显示余额。

REST API v1

开发者平台

总览

查看用量

查看工作台活动

在工作台查看近期请求、字数、订阅状态与密钥活动。

API 参考

按响应字段设计

以文档中的用量字段为准，不要从界面反推余额逻辑。

工作台

POST/api/v1/humanize

按账户隔离

带用量的调用

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"}'

说明

计量单位

改写类请求在成功返回后扣减字数。

状态接口

发送任务前可查询剩余额度与限额。

工作台

工作台汇总端点调用、订阅状态与密钥使用。

计量流程

一次请求如何计入用量

校验输入

缺少文本、不支持的载荷、超出字数或密钥无效时，请求会提前失败。

执行流程

改写、检测、引用等路由返回结构化 JSON。

记录活动

已认证的成功调用可关联端点、字数、状态与账户。

返回剩余额度

客户端可展示请求后状态，或在下一批前轮询 /api/v1/status。

用量模型

接入时需要考虑的限额

改写输入

1,000 字/次humanize、paraphrase、rewrite 共用改写限额。

检测输入

5,000 字/次检测可处理更长文本与文档摘录。

引用接口

按频率限制引用与参考文献不消耗字数额度。

速率限制

按密钥默认按密钥限流，便于区分生产与预发流量。

实现说明。 账户级用量以工作台为准。API 客户端应用状态接口做产品内余额查询。

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

总览