Skip to main content
POST
Check page for AI-sounding prose
Este endpoint analiza una página MDX o Markdown en busca de prosa que suene generada por IA y devuelve los pasajes marcados con sus rangos de líneas, además de sugerencias opcionales de reescritura al estilo humano. Úsalo para detectar contenido redactado por IA antes de que llegue a producción, o para ejecutar las mismas comprobaciones que hace la CLI mint deslop desde un pipeline de CI o una herramienta interna. El frontmatter, los bloques de código con vallas y el código en línea se eliminan antes de la puntuación, de modo que solo se analiza la prosa.

Créditos

Cada página puntuada consume 1 crédito de IA del grupo compartido de créditos de IA que también utiliza el asistente. Las páginas con menos de 50 palabras se saltan de forma gratuita (skipped: "too_short") antes de la comprobación de créditos.

Uso

Autorizaciones

Authorization
string
header
requerido

The Authorization header expects a Bearer token. Use an admin API key. This is a server-side secret key. Generate one on the API keys page in your dashboard.

Parámetros de ruta

projectId
string
requerido

Your project ID. Can be copied from the API keys page in your dashboard.

Cuerpo

application/json
path
string
requerido

Identifier for the page being checked. Echoed back in the response and used to key results when checking multiple pages.

Minimum string length: 1
content
string
requerido

Raw MDX or Markdown content of the page. Frontmatter, code blocks, and inline code are stripped before scoring so only prose is analyzed.

Maximum string length: 1000000

Respuesta

Page checked successfully. skipped is null for scored pages, or a reason string (for example, too_short) when the page was not scored. Scored pages include the AI-written fractions, per-window flagged passages with line ranges, and any rewrite suggestions.

path
string

Echo of the path from the request.

skipped
string | null

Reason the page was skipped without scoring, such as too_short when the page is under 50 words. null when the page was scored.

predictionShort
enum<string>

Short label for the overall verdict. One of Human, AI-Assisted, Mixed, or AI.

Opciones disponibles:
Human,
AI-Assisted,
Mixed,
AI
fractionAi
number

Fraction of prose (0-1) that reads as fully AI-written.

fractionAiAssisted
number

Fraction of prose (0-1) that reads as AI-assisted.

fractionHuman
number

Fraction of prose (0-1) that reads as human-written.

windows
object[]

Flagged passages with line ranges from the original page and optional rewrite suggestions.

creditsCharged
integer

AI credits charged for this request. 1 for scored pages, 0 for skipped pages.