跳至正文
TurnitPass
開發者中心API v1管理金鑰
瀏覽文件

開發者開發者

把擬人改寫與 AI 檢測接入你的產品

TurnitPass 開發者中心集中提供 API 文件、認證、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 登入。

改寫限額

1,000 字/次

humanize、paraphrase、rewrite 共用改寫字數限額,成功請求後扣減餘額。

檢測限額

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。

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