Documentation de l’API

POST/api/v1/run

Exécute une tâche d’IA sur un texte et renvoie le résultat en texte brut (sans préambule, sans bloc de code Markdown).

Requête

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

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "fr",
  "text": "Bien écrire compte beaucoup pour les étudiants.",
  "options": {}
}

Réponse

Statut 200 avec ok: true, le résultat dans output, le modèle qui a réellement répondu dans model (il diffère quand un modèle de secours a pris le relais) et la durée de traitement en millisecondes. truncated: true s’ajoute lorsque la réponse a atteint sa limite de longueur ou le délai maximal et a été coupée.

{
  "ok": true,
  "output": "La qualité de l’écriture est essentielle pour les étudiants.",
  "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":"fr","text":"Ils sont aller a la bibliotèque demain."}'

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: 'fr', 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

Choisit 4 à 8 expressions caractéristiques du texte, les recherche dans des sources ouvertes dans la langue du texte (Wikipédia, Wikisource, texte intégral d’Internet Archive, Europe PMC, DOAJ, arXiv ; un moteur de recherche web seulement s’il est configuré et demandé) et note le recouvrement. Seules ces courtes expressions quittent le serveur.

Requête

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

{ "text": "…au moins 30 mots…", "lang": "fr", "options": { "web": false } }

Réponse

Statut 200 avec score (mots concordants ÷ mots, de 0 à 1), matches par source avec des passages surlignés (positions en caractères dans votre texte), sourcesSearched (exactement les sources dont les réponses figurent dans le résultat), sourcesSkipped avec un motif, et webSearched.

{
  "ok": true,
  "score": 0.42,
  "words": 52,
  "matchedWords": 22,
  "matches": [{ "source": "wikipedia", "title": "…", "url": "https://fr.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":"fr","text":"…au moins 30 mots…"}'

GET/api/v1/health

Indique quels services sont activés. Ne prend aucun corps de requête et ne compte pas dans le quota.

Réponse

Statut 200. ai vaut false tant que l’interrupteur d’arrêt de l’IA est actif ; plagiarism liste les sources que le détecteur peut interroger ; aidetect décrit l’analyse approfondie côté serveur du détecteur IA, qui n’est pas encore déployée (POST /api/v1/aidetect répond 503 disabled ; le détecteur du site s’exécute dans votre navigateur).

{
  "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