Documentación de la API

Integra la detección de IA DeepSense™ en tu aplicación. API RESTful JSON con autenticación simple por clave.

🎛️ Modos de Sensibilidad

Elige el nivel de detección que se adapte a tu caso de uso. Pasa el parámetro sensitivity en tu solicitud.

Modo	Captura IA	Falsos Positivos	Ideal Para
conservative	Moderada	Muy Bajos	Autocomprobaciones de estudiantes, riesgo mínimo de acusaciones falsas
balanced	Alta	Bajos	Plataformas de contenido, opción predeterminada para empresas
aggressive	Muy Alta	Moderados	Filtrado por lotes con revisión humana

Autenticación

Todas las solicitudes requieren una clave API enviada como encabezado HTTP. Obtén una clave en /es/api-docs.

// Todas las solicitudes:
X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Las claves inválidas o faltantes devuelven 401. Las solicitudes con límite excedido devuelven 429 con encabezados de reintento.

Límites y Encabezados

Plan	Palabras/Mes	~Ensayos
Gratuito	10,000	~50 ensayos
Esencial	60,000	~300 ensayos
Premium	180,000	~900 ensayos
Profesional	360,000	~1,800 ensayos
Empresarial	15,000,000	~75,000 ensayos

Cada respuesta incluye encabezados de límite (conteo de palabras):

X-RateLimit-Limit: 200000
X-RateLimit-Remaining: 183700

Endpoints

POST /api/detect

Analiza texto para detectar contenido generado por IA. Mínimo 20 palabras.

Solicitud

// POST /api/detect
Content-Type: application/json
X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

{
  "text": "El rápido avance de las técnicas de aprendizaje profundo ha...",
  "sensitivity": "balanced"  // opcional: conservative | balanced | aggressive
}

Parámetros

Campo	Tipo	Requerido	Descripción
text	string	✅	Texto a analizar (mín. 20 palabras)
sensitivity	string	—	Rigor de detección: conservative (0% falsos positivos), balanced (recomendado), aggressive (máxima captura IA). Predeterminado: conservative

Respuesta

{
  "success": true,
  "score": 87,
  "verdict": "Probablemente IA",
  "docTypeLabel": "Artículo Académico",
  "totalDimensions": 21,
  "activeDimensions": 15,
  "ms_cost": 12.4,
  "rate_limit": 5000,
  "rate_remaining": 4837,
  "dimensions": [
    {
      "label": "Cociente de Cadencia Prosódica",
      "detected": true
    }
  ],
  "textAnnotations": [
    {
      "sentence": "Además, es importante...",
      "start": 420,
      "end": 510,
      "dims": [
        { "id": "template_phrases", "label": "..." }
      ]
    }
  ],
  "bullets": [
    {
      "text": "Tendencia de secuencias formulaicas detectada",
      "example": "Es importante señalar que...",
      "start": 420,
      "end": 510
    }
  ]
}

Códigos de Estado

Código	Significado
200	Detección completada
400	Falta el campo text o texto menor a 20 palabras
401	Clave API inválida o faltante
429	Cuota mensual excedida

POST /api/detect (Lote)

Sube múltiples archivos para detección por lotes. Devuelve flujo NDJSON.

Solicitud

// POST /api/detect
Content-Type: multipart/form-data
X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

files[]: ensayo1.txt
files[]: informe2.docx
files[]: documento3.pdf

Respuesta (flujo NDJSON, 1 línea por archivo)

// Transmisión en tiempo real — cada línea = 1 resultado de archivo
{"type":"progress","index":0","fileName":"ensayo1.txt","total":3"}
{"type":"result","index":0","fileName":"ensayo1.txt","score":87","verdict":"Probablemente IA","words":450","flagged":7","totalDims":15","docType":"General"}
{"type":"progress","index":1","fileName":"informe2.docx","total":3"}
{"type":"complete","total":3"}

Formatos soportados: TXT, MD, DOCX, PDF.

Ejemplos Rápidos

cURL

# Detección básica
curl -X POST https://www.anyaizero.com/api/detect \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ak_tu_clave_aqui" \
  -d '{"text":"Tu texto para analizar..."}'

# Con sensibilidad (balanced recomendado para empresas)
curl -X POST https://www.anyaizero.com/api/detect \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ak_tu_clave_aqui" \
  -d '{"text":"...", "sensitivity":"balanced"}'

Python

import requests

response = requests.post(
    "https://www.anyaizero.com/api/detect",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "ak_tu_clave_aqui"
    },
    json={"text": "Tu texto para analizar..."}
)

result = response.json()
print(f"Puntuación IA: {result['score']}% — {result['verdict']}")

JavaScript / Node

const res = await fetch("https://www.anyaizero.com/api/detect", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "ak_tu_clave_aqui"
  },
  body: JSON.stringify({ text: "Tu texto para analizar..." })
});

const data = await res.json();
console.log(`Puntuación: ${data.score}%, Veredicto: ${data.verdict}`);

FAQ

¿Cómo se cuenta el uso?

El uso se cuenta por palabras procesadas. Cada palabra del texto enviado cuenta para tu cuota mensual. Las cargas por lote cuentan el total de palabras de todos los archivos.

¿Puedo exceder mi límite mensual?

Las solicitudes devuelven 429 cuando se alcanza el límite. Contáctanos para ampliar o discutir precios por excedente.

¿Hay una clave de prueba?

Contacta api@https://www.anyaizero.com para obtener una clave de prueba con 500 llamadas gratuitas.

¿Cuál es el tiempo de respuesta?

Promedio de 10-80ms dependiendo de la longitud del texto. Sin dependencias de API externas — todo el procesamiento es interno.

¿Almacenan el texto enviado?

No. El texto se procesa en memoria y se descarta. Solo registramos metadatos (conteo de palabras, puntuación, timestamp) para fines de facturación.

¿Preguntas? Email api@https://www.anyaizero.com · Precios