Documentazione API

POST/api/v1/run

Esegue un compito AI su un testo e restituisce il risultato come testo semplice (senza preamboli e senza blocchi di codice Markdown).

Richiesta

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "it",
  "text": "Scrivere bene è importante per gli studenti.",
  "options": {}
}

Risposta

Stato 200 con ok: true, il risultato in output, il modello che ha effettivamente risposto in model (cambia se è intervenuto un modello di riserva) e il tempo di elaborazione in millisecondi. Se la risposta ha raggiunto il limite di lunghezza o di tempo ed è stata tagliata, viene aggiunto truncated: true.

{
  "ok": true,
  "output": "Saper scrivere bene è fondamentale per chi studia.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

Esempio: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"it","text":"Il libro che ho letto era un pò noioso ma l’ho finito."}'

Esempio: 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: 'it', 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

Sceglie da 4 a 8 frasi distintive del testo, le cerca in fonti aperte nella lingua del testo (Wikipedia, Wikisource, testo integrale di Internet Archive, Europe PMC, DOAJ, arXiv; un motore di ricerca web solo se configurato e richiesto) e calcola la sovrapposizione. Dal server escono soltanto quelle frasi brevi.

Richiesta

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

{ "text": "…almeno 30 parole…", "lang": "it", "options": { "web": false } }

Risposta

Stato 200 con score (parole corrispondenti ÷ parole, da 0 a 1), matches per fonte con i passages evidenziati (posizioni in caratteri nel tuo testo), sourcesSearched (esattamente le fonti le cui risposte sono nel risultato), sourcesSkipped con il motivo e webSearched.

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

Esempio: curl

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

GET/api/v1/health

Indica quali servizi sono attivi. Non ha corpo e non conta nella quota.

Risposta

Stato 200. ai è false mentre l’interruttore di emergenza dell’AI è attivo; plagiarism elenca le fonti che il controllo può interrogare; aidetect descrive l’analisi approfondita lato server del rilevatore AI, non ancora attiva (POST /api/v1/aidetect risponde 503 disabled; il rilevatore del sito funziona nel tuo browser).

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

Esempio: curl

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

Task list