Dokumentasi API

POST/api/v1/run

Menjalankan satu tugas AI pada teks dan memulangkan hasilnya sebagai teks biasa (tanpa pembukaan, tanpa pagar kod Markdown).

Permintaan

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "ms",
  "text": "Penulisan yang baik sangat penting untuk pelajar.",
  "options": {}
}

Respons

Status 200 dengan ok: true, hasil dalam output, model yang benar-benar menjawab dalam model (ia berbeza apabila model sandaran mengambil alih) dan masa pemprosesan dalam milisaat. truncated: true ditambah apabila jawapan mencapai bajet panjangnya atau had masa lalu dipotong.

{
  "ok": true,
  "output": "Kualiti penulisan amat penting bagi para pelajar.",
  "model": "@cf/aisingapore/gemma-sea-lion-v4-27b-it",
  "ms": 812
}

Contoh: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"ms","text":"Mereka pergi ke perpustakan semalam."}'

Contoh: 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: 'ms', 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

Memilih 4–8 frasa tersendiri daripada teks, mencari sumber terbuka dalam bahasa teks itu (Wikipedia, Wikisource, teks penuh Internet Archive, Europe PMC, DOAJ, arXiv; penyedia carian web hanya apabila dikonfigurasi dan diminta) dan menilai pertindihan. Hanya frasa pendek itu yang meninggalkan pelayan.

Permintaan

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

{ "text": "…sekurang-kurangnya 30 perkataan…", "lang": "ms", "options": { "web": false } }

Respons

Status 200 dengan score (perkataan sepadan ÷ perkataan, 0–1), matches bagi setiap sumber dengan passages yang diserlahkan (ofset aksara dalam teks anda), sourcesSearched (tepat sumber yang jawapannya ada dalam hasil), sourcesSkipped beserta sebab, dan webSearched.

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

Contoh: curl

curl -X POST https://adeptwrite.com/api/v1/plagiarism \
  -H "Content-Type: application/json" \
  -d '{"lang":"ms","text":"…sekurang-kurangnya 30 perkataan…"}'

GET/api/v1/health

Melaporkan perkhidmatan yang dihidupkan. Tidak mengambil badan permintaan dan tidak dikira dalam kuota.

Respons

Status 200. ai bernilai false apabila suis pemati AI dihidupkan; plagiarism menyenaraikan sumber yang boleh ditanya oleh pemeriksa; aidetect menerangkan analisis mendalam sisi pelayan bagi pengesan AI, yang belum dikerahkan (POST /api/v1/aidetect menjawab 503 disabled; pengesan di laman berjalan dalam pelayar anda).

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

Contoh: curl

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

Task list