API 文档

POST/api/v1/run

对一段文字执行一个 AI 任务，并以纯文本返回结果（没有开场白，没有 Markdown 代码围栏）。

请求

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "zh-hans",
  "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-hans","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-hans', 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 个有代表性的短语，用文本所用的语言在公开来源（维基百科、维基文库、Internet Archive 全文、Europe PMC、DOAJ、arXiv；只有在已配置且请求时才使用网页搜索服务）中检索，并计算重合程度。只有这些短短的短语会离开服务器。

请求

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

{ "text": "……至少 30 个词……", "lang": "zh-hans", "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-hans","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