Documentació de l’API

POST/api/v1/run

Executa una tasca d’IA sobre un text i retorna el resultat com a text pla (sense preàmbul ni blocs de codi Markdown).

Sol·licitud

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "ca",
  "text": "Escriure bé és molt important per als estudiants.",
  "options": {}
}

Resposta

Estat 200 amb ok: true, el resultat a output, el model que ha respost de debò a model (és diferent quan n’ha intervingut un de reserva) i el temps de processament en mil·lisegons. S’hi afegeix truncated: true quan la resposta ha arribat al límit de longitud o de temps i s’ha tallat.

{
  "ok": true,
  "output": "Redactar amb correcció és essencial per als estudiants.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Exemple: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"ca","text":"Tinc que anar a la biblioteca demà."}'

Exemple: 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: 'ca', 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

Tria de 4 a 8 frases distintives del text, les cerca en fonts obertes en la llengua del text (Viquipèdia, Wikisource, text complet d’Internet Archive, Europe PMC, DOAJ, arXiv; un proveïdor de cerca web només si està configurat i es demana) i en puntua la coincidència. Només aquestes frases curtes surten del servidor.

Sol·licitud

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

{ "text": "…almenys 30 paraules…", "lang": "ca", "options": { "web": false } }

Resposta

Estat 200 amb score (paraules coincidents ÷ paraules, de 0 a 1), matches per font amb passages destacats (desplaçaments de caràcters dins del vostre text), sourcesSearched (exactament les fonts les respostes de les quals són al resultat), sourcesSkipped amb el motiu, i webSearched.

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

Exemple: curl

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

GET/api/v1/health

Indica quins serveis són actius. No té cos i no compta per a la quota.

Resposta

Estat 200. ai és fals mentre l’interruptor d’emergència de la IA és activat; plagiarism llista les fonts que el detector pot consultar; aidetect descriu l’anàlisi profunda al servidor del detector d’IA, que encara no està desplegada (POST /api/v1/aidetect respon 503 disabled; el detector del lloc s’executa al vostre navegador).

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

Exemple: curl

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

Task list