Flujo de AI-Detection + Humanizer

Buscadores y plataformas son cada vez más sensibles a patrones típicos de IA: longitudes de frase uniformes, «It's important to note», listas hiperestructuradas. Rankion te da dos herramientas — un AI-Detector que escanea el texto buscando probabilidad de IA y un Humanizer que lo hace activamente más natural.

Single-Shot Detection

Comprobación rápida para un fragmento de texto (p. ej. un párrafo recién escrito o un artículo entregado por un cliente):

curl -X POST https://rankion.ai/api/v1/ai-scanner/detect \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Es importante señalar que la inteligencia artificial..."}'

Coste: 2 créditos. La respuesta te da una ai_probability (0–100) y un heatmap a nivel de frase, indicando qué oraciones suenan especialmente a IA.

A partir de ai_probability ≥ 70, deberías humanizar. Por debajo de 40 suele estar bien.

Article-Humanizer

Si quieres pasar un artículo completo (p. ej. uno recién generado por el AI Content Editor) por el Humanizer:

curl -X POST https://rankion.ai/api/v1/ai-scanner/humanize \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Tu texto completo del artículo aquí...",
    "tone": "natural",
    "language": "es"
  }'

Coste: 5 créditos. Síncrono, responde directamente con el texto reescrito. Duración: 5–15 segundos.

El Humanizer varía la longitud de las frases, introduce imperfecciones (frases cortas, signos de interrogación, inversiones), reemplaza muletillas típicas de LLM por formulaciones cotidianas — manteniendo a la vez la fidelidad semántica.

Bulk-Humanizer (asíncrono + polling de batch)

Para cantidades mayores (10+ artículos, pipelines de contenido enteras) existe el Bulk-Humanizer asíncrono:

# Iniciar batch:
curl -X POST https://rankion.ai/api/v1/humanize \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": [
      {"id": "art-1", "content": "..."},
      {"id": "art-2", "content": "..."},
      {"id": "art-3", "content": "..."}
    ],
    "tone": "natural"
  }'

Coste: 8 créditos por texto. Respuesta: HTTP 202 con batch_id.

Después haces polling:

curl https://rankion.ai/api/v1/humanize/{batch_id} \
  -H "Authorization: Bearer TU_TOKEN"

Mientras status: "processing", sigue corriendo. Con status: "completed", results[] contiene las versiones humanizadas por ID de input. Tiempo de ejecución típico: de 30 segundos a 5 minutos según el tamaño del batch.

Cuándo usarlo — cuándo no

Usarlo cuando:

• El artículo viene directamente del AI Content Editor y ha de quedar listo para publicar en money pages
• Los textos se entregan en plataformas con AI-Detection (universidades, algunos marketplaces)
• Quieres construir una serie de contenido con voz natural y consistente

No usarlo cuando:

• El texto ya se ha revisado manualmente — el Humanizer puede introducir entonces saltos de estilo
• Se trata de contenidos muy técnicos o factuales (código, números, definiciones) — el Humanizer puede aflojar lo que no debería aflojarse
• La tonalidad debe ser «expert / formal» — el default del Humanizer tira hacia lo coloquial

Quality Gate antes de publicar

Flujo recomendado para un artículo final:

1. Generar (Tu primer artículo con el AI Content Editor)
2. Score y Optimize (Optimizar contenido para Google + IA)
3. AI-Detection — comprobar ai_probability
4. Si ≥ 70 → Humanize
5. Re-Detection → debe ser < 40
6. Edición final manual (con 5 min suele bastar)
7. Publicar

Detalles del módulo y límites en AI-Detector y Humanizer. Referencia de API: API de AI Tools (Detector + Humanizer).