API de AI Detector y documentación del servidor MCP

Acceso

Autenticación

La API REST y los clientes MCP locales usan claves de API en encabezados diferentes. Los conectores MCP alojados descubren OAuth y abren un flujo de autorización en el navegador.

Seguridad de uso

Repite una solicitud sin pagar dos veces

Las nuevas integraciones deben enviar un Idempotency-Key único por cada solicitud REST lógica y conservarlo hasta que la solicitud se complete o decidas abandonarla. Si se corta la conexión, repite exactamente el mismo endpoint, text, version o model y la misma clave. La repetición exacta devuelve la respuesta guardada sin ejecutar de nuevo el proveedor ni volver a descontar palabras.

Mientras la primera llamada mantiene la reserva de procesamiento, un reintento simultáneo exacto devuelve HTTP 409 con Retry-After. Al completarse, la respuesta exacta puede recuperarse durante 24 horas. Cuando ese cuerpo privado caduca, la misma clave devuelve HTTP 410. El registro permanente de la operación sigue impidiendo un segundo cobro.

Endpoint REST

API del detector de IA

Analiza el texto proporcionado en busca de patrones asociados con la escritura de IA. Los resultados son señales probabilísticas para revisión, no pruebas de autoría.

Cuerpo de la solicitud

curl --request POST \
  --url https://api.detecting-ai.com/api/detect/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: detector-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to analyze.",
    "version": "v3"
  }'

Respuesta

{
  "success": true,
  "data": {
    "details": {
      "chunks": [
        {
          "text": "A sentence from the input.",
          "startChar": 0,
          "endChar": 26,
          "type": "AI",
          "score": 0.87
        }
      ],
      "ai_percentage": 42.5
    },
    "version": "v3",
    "words_processed": 120
  }
}

Lee la descripción general de la API del detector de IA

Endpoint REST

API del Humanizador de IA

Reescribe el texto proporcionado con el modelo de humanización seleccionado. El resultado es editable y debe revisarse para comprobar el significado, los hechos, los nombres, los enlaces, el tono y la terminología necesaria.

Cuerpo de la solicitud

curl --request POST \
  --url https://api.detecting-ai.com/api/humanize/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: humanizer-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to rewrite.",
    "model": "cognia"
  }'

Respuesta

{
  "humanized_text": "The rewritten text is returned here.",
  "words_processed": 120,
  "model_used": "cognia"
}

Consulta la API del Humanizador de IA

Endpoint REST

API del detector de plagio

Busca coincidencias por oración y devuelve el contexto de la fuente cuando encuentra alguna. Cada coincidencia requiere revisión humana, porque las citas, los permisos y las fórmulas habituales afectan a su significado.

Cuerpo de la solicitud

curl --request POST \
  --url https://api.detecting-ai.com/api/plagiarism/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: plagiarism-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to check."
  }'

Respuesta

{
  "result": {
    "results": [
      {
        "sentence": "A sentence from the input.",
        "is_plagiarised": true,
        "web_sentence": "A similar source sentence.",
        "similarity": 91.0,
        "link": "https://example.com/source"
      }
    ],
    "plagiarism_score": 34.2
  },
  "words_processed": 120
}

Lee la descripción general de la API del detector de plagio

Streamable HTTP

Servidor MCP remoto

Un servidor remoto ofrece exactamente dos herramientas: detect_ai_text y humanize_text. La verificación de plagio está disponible mediante la API REST, no mediante MCP.

Conectores alojados

Añade solo la URL de MCP a un conector alojado. El cliente descubre OAuth, abre el inicio de sesión y el consentimiento en el navegador y guarda sus propios tokens. No añadas una clave de API ni ninguna otra credencial a la URL.

Codex

export DETECTING_AI_API_KEY="YOUR_API_KEY"

[mcp_servers.detecting_ai]
url = "https://api.detecting-ai.com/api/mcp"
bearer_token_env_var = "DETECTING_AI_API_KEY"
tool_timeout_sec = 300

Claude Code

claude mcp add --transport http --scope user \
  --header "Authorization: Bearer YOUR_API_KEY" \
  detecting-ai https://api.detecting-ai.com/api/mcp

Gestión de errores

Errores

Comprueba tanto el estado HTTP como el cuerpo de la respuesta. Las respuestas de error aún no están normalizadas en un esquema universal.

Cuotas y límites

Uso y límites

El uso se cobra según el número de palabras de entrada separadas por espacios en blanco. Los saldos del detector, el humanizador y el plagio son específicos de cada función, incluso cuando la misma clave accede a más de un producto.

• Consulta las palabras restantes y los planes activos en el panel de la API.
• MCP usa el mismo saldo del detector o del humanizador que la API REST correspondiente.
• La API REST y MCP admiten de forma predeterminada hasta 160.000 caracteres por texto. MCP también limita el cuerpo de transporte a 1 MiB. Divide los documentos especialmente grandes en secciones con sentido.