Detectar prosa que suena a IA

POST

deslop

{projectId}

Detectar prosa que suena a IA en una página

curl --request POST \
  --url https://api.mintlify.com/v1/deslop/{projectId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "path": "<string>",
  "content": "<string>"
}
'

import requests

url = "https://api.mintlify.com/v1/deslop/{projectId}"

payload = {
    "path": "<string>",
    "content": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({path: '<string>', content: '<string>'})
};

fetch('https://api.mintlify.com/v1/deslop/{projectId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mintlify.com/v1/deslop/{projectId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'path' => '<string>',
    'content' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mintlify.com/v1/deslop/{projectId}"

	payload := strings.NewReader("{\n  \"path\": \"<string>\",\n  \"content\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mintlify.com/v1/deslop/{projectId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"path\": \"<string>\",\n  \"content\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mintlify.com/v1/deslop/{projectId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"path\": \"<string>\",\n  \"content\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "path": "<string>",
  "creditsCharged": 123,
  "fractionAi": 123,
  "fractionAiAssisted": 123,
  "fractionHuman": 123,
  "windows": [
    {
      "text": "<string>",
      "label": "<string>",
      "aiAssistanceScore": 123,
      "startLine": 123,
      "endLine": 123,
      "confidence": "<string>",
      "rewrites": [
        {
          "text": "<string>",
          "rationale": "<string>"
        }
      ]
    }
  ]
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Este endpoint analiza una página de documentación en busca de prosa generada por IA y devuelve los pasajes marcados con reescrituras humanas sugeridas. Autentícate con una clave de API de administrador.

Créditos

Consume 1 crédito de IA por página comprobada.
Las páginas con menos de 50 palabras se omiten y no se cobran. La respuesta devuelve skipped: "too_short" con creditsCharged: 0.
Si la detección no está disponible temporalmente, el endpoint devuelve 503 y no se cobra ningún crédito.

Respuesta

Las páginas comprobadas devuelven un veredicto (predictionShort), fracciones de IA y humana, y un arreglo windows de pasajes marcados. Cada window incluye un rango de líneas y una reescritura sugerida.

Uso

curl -X POST https://api.mintlify.com/v1/deslop/{projectId} \
  -H "Authorization: Bearer mint_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "guides/quickstart.mdx",
    "content": "# Quickstart\n\nWelcome to our comprehensive documentation..."
  }'

Autorizaciones

Authorization

string

header

requerido

El encabezado Authorization requiere un token de tipo Bearer. Usa una clave de API de administrador. Esta es una clave secreta del lado del servidor. Genera una en la página de claves de API de tu dashboard.

Parámetros de ruta

projectId

string

requerido

El ID de tu proyecto. Se puede copiar desde la página de claves de API en tu panel de control.

Cuerpo

application/json

path

string

requerido

Ruta de la página relativa al repositorio, utilizada solo para informes.

Minimum string length: 1

content

string

requerido

El contenido MDX o Markdown sin procesar de la página que se va a comprobar.

Minimum string length: 1

Respuesta

La página se comprobó, o se omitió porque era demasiado corta.

path

string

requerido

La ruta proveniente de la solicitud.

skipped

enum<string> | null

requerido

Motivo por el que se omitió la página, o null cuando la página se comprobó. too_short significa que la página tenía menos de 50 palabras de prosa y no se cobró.

Opciones disponibles:

too_short,

null

creditsCharged

integer

requerido

Créditos de IA cobrados por esta solicitud (0 cuando se omite).

predictionShort

enum<string>

Veredicto general de la página. Presente solo cuando la página se comprobó.

Opciones disponibles:

AI,

AI-Assisted,

Human,

Mixed

fractionAi

number

Fracción de la página detectada como generada por IA (0-1).

fractionAiAssisted

number

Fracción detectada como asistida por IA (0-1).

fractionHuman

number

Fracción detectada como escrita por humanos (0-1).

windows

object[]

Pasajes marcados (no humanos). Presente solo cuando la página se comprobó.

Show child attributes

Temas relacionados

Comandos Solución de problemas Cómo mantener la documentación a lo largo del tiempo

Activar automatización

Crear tarea de agente

⌘I

Detectar prosa que suena a IA en una página

curl --request POST \
  --url https://api.mintlify.com/v1/deslop/{projectId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "path": "<string>",
  "content": "<string>"
}
'

import requests

url = "https://api.mintlify.com/v1/deslop/{projectId}"

payload = {
    "path": "<string>",
    "content": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({path: '<string>', content: '<string>'})
};

fetch('https://api.mintlify.com/v1/deslop/{projectId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mintlify.com/v1/deslop/{projectId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'path' => '<string>',
    'content' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mintlify.com/v1/deslop/{projectId}"

	payload := strings.NewReader("{\n  \"path\": \"<string>\",\n  \"content\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mintlify.com/v1/deslop/{projectId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"path\": \"<string>\",\n  \"content\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mintlify.com/v1/deslop/{projectId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"path\": \"<string>\",\n  \"content\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "path": "<string>",
  "creditsCharged": 123,
  "fractionAi": 123,
  "fractionAiAssisted": 123,
  "fractionHuman": 123,
  "windows": [
    {
      "text": "<string>",
      "label": "<string>",
      "aiAssistanceScore": 123,
      "startLine": 123,
      "endLine": 123,
      "confidence": "<string>",
      "rewrites": [
        {
          "text": "<string>",
          "rationale": "<string>"
        }
      ]
    }
  ]
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Referencia de la API

Administración

Agente

assistant

Analytics

Exportación estática

Detectar prosa que suena a IA

Créditos

Respuesta

Uso

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

​Créditos

​Respuesta

​Uso

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Créditos

Respuesta

Uso