瀏覽文件

TurnitPass REST API

端點、參數、限制與錯誤碼。

POST/api/v1/humanize

降低文字中的 AI 寫作訊號。模式：reduce-aigc、reduce-both、paraphrase、academic-polish。

參數	類型	預設值	說明
`text`必填	string	—	待改寫的文字。至少 3 個詞單位，每次請求最多 500 品質單位。
`language`	string	en	語言代碼，如 en 或 zh。
`mode`	enum	reduce-aigc	`reduce-aigc, reduce-both, paraphrase, academic-polish`
`personal_terms`	string[]	—	最多 30 個需保持不變的名稱或術語，每個最長 120 字元。

請求

POST /api/v1/humanize

1{ "text": "貼上需要修改的草稿。", "language": "zh-Hant", "mode": "reduce-aigc" }

回應

200 OK

1{
2  "output": "…",
3  "words_used": 142,
4  "words_remaining": 2858,
5  "usage": { "words": 142, "characters": 861 },
6  "metrics": { "kind": "heuristic_estimate", "aiLikeScore": 18, "naturalTone": 82, "sentenceVariety": 74, "readability": 68 }
7}

POST/api/v1/paraphrase

以 standard、fluency、formal、academic、simple、creative、expand 或 shorten 模式改寫文字。synonyms_level 範圍為 0 到 100。

參數	類型	預設值	說明
`text`必填	string	—	待改寫的文字。每次請求最多 2,000 品質單位。
`language`	string	en	語言代碼，如 en 或 zh。
`mode`	enum	standard	`standard, fluency, formal, academic, simple, creative, expand, shorten`
`synonyms_level`	integer	50	詞語替換的幅度，範圍 0 到 100。

請求

POST /api/v1/paraphrase

1{ "text": "貼上需要修改的草稿。", "language": "zh-Hant", "mode": "academic", "synonyms_level": 60 }

回應

200 OK

1{
2  "output": "…",
3  "words_used": 142,
4  "words_remaining": 2858,
5  "usage": { "words": 142, "characters": 861 }
6}

POST/api/v1/rewrite

學術潤飾，調整結構、語氣和句子銜接。

參數	類型	預設值	說明
`text`必填	string	—	待改寫的文字。至少 3 個詞單位，每次請求最多 500 品質單位。
`language`	string	en	語言代碼，如 en 或 zh。

請求

POST /api/v1/rewrite

1{ "text": "貼上需要修改的草稿。", "language": "zh-Hant" }

回應

200 OK

1{
2  "output": "…",
3  "words_used": 142,
4  "words_remaining": 2858,
5  "usage": { "words": 142, "characters": 861 }
6}

POST/api/v1/detect

為貼上的文字或擷取的文件回傳 AI 分數、寫作訊號和修改建議。source_kind：paste、pdf、docx 或 txt。

參數	類型	預設值	說明
`text`必填	string	—	待偵測的文字。最多 5,000 詞或 30,000 字元。
`language`	string	en	語言代碼，如 en 或 zh。
`source_kind`	enum	paste	`paste, pdf, docx, txt`
`original_filename`	string	—	原始檔名，最長 255 字元。

請求

POST /api/v1/detect

1{ "text": "貼上需要修改的草稿。", "language": "zh-Hant", "source_kind": "paste" }

回應

200 OK

1{
2  "score": 62,
3  "label": "…",
4  "risk_level": "high",
5  "signals": [{ "key": "…", "label": "…", "value": 0.7, "level": "medium", "detail": "…" }],
6  "passages": [{ "text": "…", "label": "ai", "level": "high" }],
7  "detection_quota": { "limit": 10, "remaining": 9, "resets_at": "2026-10-25T00:00:00Z" }
8}

POST/api/v1/citation

將 DOI、URL 或手動輸入的引用格式化為 22 種格式，包括 APA、MLA、Chicago、IEEE、Harvard、Nature、Vancouver、ACS、AMA、GB/T 7714、OSCOLA 和 Bluebook。回應包含 html、text、BibTeX 和 RIS。

參數	類型	預設值	說明
`input`	string	—	DOI、URL 或文獻標題，最長 2,000 字元。與 citation 二選一。
`citation`	object	—	包含標題、作者與來源資訊的引用物件。與 input 二選一。
`style`	string	apa	引用格式標識，如 apa、mla 或 chicago。

請求

POST /api/v1/citation

1{ "input": "10.1038/nature14539", "style": "apa" }

回應

200 OK

1{
2  "citation": { "title": "…", "authors": [{ "firstName": "…", "lastName": "…" }] },
3  "style": "apa",
4  "html": "…",
5  "text": "…",
6  "bibtex": "…",
7  "ris": "…"
8}

POST/api/v1/bibliography

依指定格式排序並格式化引用清單，輸出 html 和 text，並支援匯出 BibTeX 和 RIS。

參數	類型	預設值	說明
`citations`必填	object[]	—	1 到 100 個引用物件，每個包含 id 與 title。
`style`	string	apa	引用格式標識，如 apa、mla 或 chicago。

請求

POST /api/v1/bibliography

1{ "citations": [{ "id": "1", "title": "…", "authors": [] }], "style": "apa" }

回應

200 OK

1{
2  "style": "apa",
3  "entries": [{ "citation": { "id": "1" }, "html": "…", "text": "…" }],
4  "html": "…",
5  "text": "…",
6  "bibtex": "…",
7  "ris": "…"
8}

GET/api/v1/status

回傳金鑰名稱、剩餘字數、單次請求限制、檢測次數和速率限制。

此端點不需要參數。

回應

200 OK

1{
2  "name": "Production",
3  "words_remaining": 2858,
4  "max_humanize_quality_units": 500,
5  "max_paraphrase_quality_units": 2000,
6  "max_detection_words_per_request": 5000,
7  "max_detection_characters": 30000,
8  "detection_quota": { "limit": 10, "remaining": 9, "resets_at": "2026-10-25T00:00:00Z" },
9  "rate_limit_per_minute": 50
10}

參數與選項

驗證

Authorization: Bearer tp_live_your_api_key

擬人改寫詞彙

選填的 personal_terms 陣列（最多 30 個），在英文擬人改寫中保持人名、專業術語和品牌拼寫不變。

速率限制與請求限制

擬人改寫和學術改寫

每次請求 500 個單位1 個漢字計 1 個單位，3 個其他字元計 1 個單位，不足 1 個單位以 1 個計。所有方案限制相同。

改寫潤飾

每次請求 2,000 個單位計算方式相同。

AI 檢測

每次 5,000 字或 30,000 個字元計入每日檢測次數。較長的文件請拆分。

速率限制

每把金鑰每分鐘 50 次請求引用和參考文獻為 100 次，且不扣字數。

API 金鑰

最多 5 把有效金鑰

錯誤處理

錯誤以 JSON 傳回，包含 error、code 和 message 欄位。

400

invalid_input, quality_limit_exceeded, word_limit_exceeded

401

missing_api_key, invalid_api_key

403

insufficient_words, daily_detection_limit

429

rate_limited

500

internal_error

回應

400

1{
2  "error": "quality_limit_exceeded",
3  "code": "quality_limit_exceeded",
4  "message": "Up to 500 Chinese or 1,500 English characters per request."
5}

對 429 和 5xx 使用退避重試。4xx 需先修正請求再重試。

範例

擬人改寫

JSON

1POST /api/v1/humanize
2{
3  "text": "貼上需要修改的草稿。",
4  "language": "zh-Hant",
5  "mode": "reduce-aigc",
6  "personal_terms": ["TurnitPass"]
7}
8
9200 OK
10{
11  "output": "…",
12  "words_used": 142,
13  "words_remaining": 2858,
14  "usage": { "words": 142, "characters": 861 },
15  "metrics": { "kind": "heuristic_estimate", "aiLikeScore": 18, "naturalTone": 82, "sentenceVariety": 74, "readability": 68 }
16}

改寫潤飾、AI 檢測和引用

JSON

1POST /api/v1/paraphrase
2{
3  "text": "貼上需要修改的草稿。",
4  "language": "zh-Hant",
5  "mode": "academic",
6  "synonyms_level": 60
7}
8
9POST /api/v1/detect
10{
11  "text": "貼上需要修改的草稿。",
12  "language": "zh-Hant",
13  "source_kind": "paste"
14}
15
16POST /api/v1/citation
17{
18  "input": "https://example.com/article",
19  "style": "apa"
20}

TurnitPass REST API

參數與選項

速率限制與請求限制

錯誤處理

範例

下一步

快速入門

驗證