API de TrazaIA

Analizar un texto

curl -X POST https://TU-DOMINIO/api/v1/analizar \
  -H "Content-Type: application/json" \
  -H "X-TrazaIA-Clave: TZ-tu-codigo" \
  -d '{"texto": "Tu texto de al menos 250 palabras…"}'

La cabecera X-TrazaIA-Clave es opcional en la beta: sin ella aplican los límites gratuitos por dirección IP.

Respuesta

{
  "veredicto": "mixto",            // humano | mayormente_humano | mixto | ia | insuficiente
  "ia_pct": 42.5,                  // % de palabras dentro de pasajes con IA
  "palabras": 812,
  "tramos": [                      // pasajes marcados, en posiciones de caracteres
    {"inicio": 1520, "fin": 3104, "palabras": 241}
  ],
  "parrafos": [                    // proporción con IA de cada párrafo
    {"inicio": 0, "fin": 640, "palabras": 98, "ia": 0.0}
  ],
  "motor": "TrazaIA beta 0.1 · motor TZ-1 (octubre 2026)",
  "cupo": {"usados": 3, "limite": 300, "restantes": 297, "con_codigo": true},
  "fecha": "2026-10-24T15:02:11Z"
}

Extraer texto de un archivo

curl -X POST https://TU-DOMINIO/api/v1/extraer -F "archivo=@documento.pdf"

Devuelve {"nombre", "texto", "palabras"}. Admite PDF con texto, DOCX, TXT y Markdown de hasta 10 MB.

Consultar el cupo

curl https://TU-DOMINIO/api/v1/cupo -H "X-TrazaIA-Clave: TZ-tu-codigo"

Errores