API 문서

POST/api/v1/run

글 하나에 AI 작업 하나를 실행하고 결과를 일반 텍스트로 돌려줍니다(머리말도 Markdown 코드 블록도 없음).

요청

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "ko",
  "text": "리포트를 잘 쓰는 것은 대학생에게 정말 중요하다.",
  "options": {}
}

응답

상태 200과 함께 ok: true, 결과를 담은 output, 실제로 답한 모델을 알리는 model(대체 모델이 나서면 달라집니다), 처리 시간(밀리초)을 돌려줍니다. 답변이 길이 한도나 제한 시간에 걸려 잘리면 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":"ko","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: 'ko', 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": "ko", "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://ko.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":"ko","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