瀏覽文件

檢視請求、字數、端點與剩餘額度

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

說明

計量單位

改寫類請求在成功回傳後扣抵字數額度。

狀態端點

傳送任務前可預先查詢剩餘額度與限額。

工作台

工作台彙整端點呼叫、訂閱狀態與金鑰使用紀錄。

計量流程

單次 API 請求如何計入用量

驗證輸入

缺少文字、不支援的資料格式、超出字數上限或金鑰無效時，請求將提前中斷並回傳錯誤。

執行作業

改寫、檢測、引用等端點依需求運算並回傳結構化 JSON。

紀錄活動

通過驗證的成功呼叫將關聯端點、消耗字數、狀態碼與所屬帳戶。

回傳剩餘額度

用戶端可直接顯示請求後的最新狀態，或於批次作業前輪詢 /api/v1/status。

用量模型

串接時需留意的上限規格

改寫輸入

1,000 字/次humanize、paraphrase、rewrite 共用改寫上限。

檢測輸入

5,000 字/次AI 檢測端點可處理長篇文章與論文摘錄。

引用介面

依頻率限制文獻引用與參考文獻格式整理不消耗字數額度。

頻率限制

依金鑰計預設依金鑰進行流量管控，利於區隔正式與測試流量。

實作說明。 帳戶層級的用量以工作台紀錄為準。API 用戶端可呼叫狀態端點取得產品內餘額。

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

總覽