API ஆவணம்

POST/api/v1/run

ஒரு உரையில் ஒரு AI பணியை இயக்கி, முடிவை எளிய உரையாகத் தருகிறது (முன்னுரை இல்லை, Markdown வேலிகள் இல்லை).

கோரிக்கை

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "ta",
  "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":"ta","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: 'ta', 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": "ta", "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://ta.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":"ta","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