API ਦਸਤਾਵੇਜ਼

POST/api/v1/run

ਲਿਖਤ ਉੱਤੇ ਇੱਕ ਏਆਈ ਕੰਮ ਚਲਾਉਂਦਾ ਹੈ ਅਤੇ ਨਤੀਜਾ ਸਾਦੀ ਲਿਖਤ ਵਜੋਂ ਮੋੜਦਾ ਹੈ (ਕੋਈ ਭੂਮਿਕਾ ਨਹੀਂ, Markdown ਵਾੜ ਨਹੀਂ)।

ਬੇਨਤੀ

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "pa",
  "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":"pa","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: 'pa', 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": "pa", "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://pa.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":"pa","text":"…ਘੱਟੋ-ਘੱਟ 30 ਸ਼ਬਦ…"}'

GET/api/v1/health

ਦੱਸਦਾ ਹੈ ਕਿ ਕਿਹੜੀਆਂ ਸੇਵਾਵਾਂ ਚਾਲੂ ਹਨ। ਕੋਈ ਬਾਡੀ ਨਹੀਂ ਲੈਂਦਾ ਅਤੇ ਕੋਟੇ ਵਿੱਚ ਨਹੀਂ ਗਿਣਿਆ ਜਾਂਦਾ।

ਜਵਾਬ

ਸਟੇਟਸ 200। ਏਆਈ ਕਿੱਲ ਸਵਿੱਚ ਚਾਲੂ ਹੋਵੇ ਤਾਂ ai false ਹੁੰਦਾ ਹੈ; plagiarism ਉਹ ਸਰੋਤ ਦਿਖਾਉਂਦਾ ਹੈ ਜੋ ਜਾਂਚ ਖੰਗਾਲ ਸਕਦੀ ਹੈ; aidetect ਏਆਈ ਡਿਟੈਕਟਰ ਦੇ ਸਰਵਰ-ਪਾਸੇ ਦੇ ਡੂੰਘੇ ਵਿਸ਼ਲੇਸ਼ਣ ਦਾ ਵੇਰਵਾ ਦਿੰਦਾ ਹੈ, ਜੋ ਅਜੇ ਤੈਨਾਤ ਨਹੀਂ ਹੋਇਆ (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