API 文件

POST/api/v1/run

對一段文字執行一項 AI 任務，並以純文字回傳結果（沒有開場白，也沒有 Markdown 程式碼框）。

請求

POST /api/v1/run HTTP/1.1
Content-Type: application/json

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "zh-hant",
  "text": "好的寫作能力對學生真的很重要。",
  "options": {}
}

回應

狀態碼 200，ok: true，結果放在 output，實際回答的模型放在 model（備援模型接手時會不同），處理時間（毫秒）放在 ms。如果答案用完長度預算或達到時間上限而被截斷，會加上 truncated: true。

{
  "ok": true,
  "output": "優良的寫作能力對學生而言至關重要。",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

範例: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"zh-hant","text":"他們明天要去圖書館借書，所已今天先整理書單。"}'

範例: JavaScript (fetch)

const res = await fetch('/api/v1/run', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ task: 'summarize', mode: 'Poin-poin', lang: 'zh-hant', text }),
});
const data = await res.json();
if (!data.ok) throw new Error(data.error.code + ': ' + data.error.message);
console.log(data.output);

POST/api/v1/plagiarism

從文字中挑出 4 到 8 個有特色的片語，在該文字語言的開放來源中搜尋（Wikipedia、Wikisource、Internet Archive 全文、Europe PMC、DOAJ、arXiv；只有在已設定並且被要求時才使用網路搜尋供應商），再計算重疊分數。只有這些簡短的片語會離開伺服器。

請求

POST /api/v1/plagiarism HTTP/1.1
Content-Type: application/json

{ "text": "……至少 30 個字詞……", "lang": "zh-hant", "options": { "web": false } }

回應

狀態碼 200，包含 score（相符字詞數 ÷ 字詞數，0 到 1）、依來源列出的 matches（含標示出的 passages，為您文字中的字元偏移量）、sourcesSearched（正好是其回應已納入結果的來源）、附有原因的 sourcesSkipped，以及 webSearched。

{
  "ok": true,
  "score": 0.42,
  "words": 52,
  "matchedWords": 22,
  "matches": [{ "source": "wikipedia", "title": "……", "url": "https://zh.wikipedia.org/wiki/……",
                "matchedWords": 22, "passages": [{ "start": 0, "end": 131, "text": "……" }] }],
  "sourcesSearched": ["wikipedia", "wikisource", "internet-archive-fts", "europepmc", "doaj"],
  "sourcesSkipped": [],
  "webSearched": false,
  "ms": 2310
}

範例: curl

curl -X POST https://adeptwrite.com/api/v1/plagiarism \
  -H "Content-Type: application/json" \
  -d '{"lang":"zh-hant","text":"……至少 30 個字詞……"}'

GET/api/v1/health

回報目前開啟了哪些服務。不需要請求內容，也不計入額度。

回應

狀態碼 200。AI 緊急關閉開關啟用時，ai 為 false；plagiarism 列出抄襲檢查可以查詢的來源；aidetect 描述 AI 偵測器在伺服器端的深度分析，這項功能尚未部署（POST /api/v1/aidetect 會回應 503 disabled；網站上的偵測器在您的瀏覽器中執行）。

{
  "ok": true,
  "ai": true,
  "plagiarism": { "enabled": true, "sources": ["wikipedia", "wikisource", "internet-archive-fts", "europepmc", "doaj", "arxiv"], "web": false },
  "aidetect": { "enabled": false, "judge": false }
}

範例: curl

curl https://adeptwrite.com/api/v1/health

Task list