跳至正文
TurnitPass
開發者API v1取得 API 金鑰
瀏覽文件

開發者開發者文件

TurnitPass API 文件

使用 API 金鑰呼叫擬人改寫、AI 檢測和引用端點。

快速範例

用 API 金鑰向 /humanize 傳送文字。回應會傳回改寫後的文字、已用字數和剩餘餘額。

POST /api/v1/humanize
curl -X POST https://turnitpass.com/api/v1/humanize \
  -H "Authorization: Bearer tp_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text":"貼上需要修改的草稿。","language":"zh-Hant","mode":"reduce-aigc"}'
回應
200 OK
{
  "output": "…",
  "words_used": 142,
  "words_remaining": 2858,
  "usage": { "words": 142, "characters": 861 },
  "metrics": { "kind": "heuristic_estimate", "aiLikeScore": 18, "naturalTone": 82, "sentenceVariety": 74, "readability": 68 }
}

文件

請求流程

  1. 1驗證金鑰
  2. 2檢查輸入
  3. 3執行工具
  4. 4扣除字數並回應

上線檢查清單

伺服器端呼叫
不要把 API 金鑰打包進用戶端從後端、worker 或 server action 呼叫 TurnitPass。
重試
重試 429 和 5xx,不重試 4xx收到 4xx 時先修正請求內容再重試。
字數餘額
大型任務前先呼叫 /status將任務排入佇列、提示使用者加值,或拆分文件。