detect-ai-text

AI-Text Detection

Estimate the probability that a document's prose was written by AI, with the specific linguistic tells and an honest abstention when the document isn't prose. Uses the Stipple API (free anonymous tier).

When to use

• Educators screening student submissions
• Publishers and platforms triaging inbound content
• HR reviewing AI-drafted CVs (flag, don't reject)
• Researchers checking source provenance

Instructions

1. Get the document. URL, local file path (PDF, DOCX, TXT, MD), or raw text via --text.

1. Run detection.

``bash curl -X POST https://www.stipple.sh/v1/detect-ai-text \ -F "file=@essay.pdf" \ -H "Authorization: Bearer $STIPPLE_API_KEY" ``

For raw text: POST JSON {"text": "..."} to the same endpoint.

1. Interpret the response.

• applicable: false — the document is not prose (forms, tables, scans, spreadsheets). Detection is deliberately refused rather than guessed. Report this and stop.
• probability — model confidence (0–1), NOT a calibrated truth
• lean — "ai" | "human" | "unsure"
• tells[] — the specific phrases/patterns flagged (e.g. "It is important to note that", uniform sentence length, low burstiness)
• reasoning — why the model reached its verdict
• limitations — always present; the API states its own noise profile

1. Report honestly. This measures *