APIドキュメント

POST/api/v1/run

文章に対してAIのタスクを1つ実行し、結果をプレーンテキスト（前置きやMarkdownのブロックなし）で返します。

リクエスト

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "ja",
  "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 "Authorization: Bearer aw_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"ja","text":"私は昨日、図書館え行って本お借りました。"}'

例: JavaScript (fetch)

// adeptwrite.comのページ上のスクリプトから呼び出す場合（キーは不要）
const res = await fetch('/api/v1/run', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ task: 'summarize', mode: 'Poin-poin', lang: 'ja', 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": "ja", "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://ja.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 "Authorization: Bearer aw_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"lang":"ja","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