瀏覽文件

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 在部署时填入。

产品接入应为每个环境单独准备一把金鑰。生产、預發与本地应可獨立撤銷。

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