Cómo se usa.

Una capa entre tu app y los proveedores de IA. Cada request pasa primero por nosotros: agregamos contexto de tu marca, lo enviamos al modelo, revisamos la respuesta antes de devolverla.

Cuatro modalidades: texto, código, imagen, URL. Cada una con su propio pipeline de detección y corrección.

1. Crea tu cuenta en /login. Te llega un correo, le haces clic, entras.
2. En el primer ingreso te pedimos crear una API key. Cópiala: solo la verás esa vez.
3. En /connect tienes el snippet listo para tu SDK, editor o llamada directa.
4. Cambias la URL base, ya está. Tu código sigue igual.

OpenAI SDK

import OpenAI from 'openai';

const ai = new OpenAI({
  apiKey: 'esencia_sk_…',
  baseURL: 'https://gateway.appesencia.com/openai/v1',
});

const r = await ai.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [{ role: 'user', content: 'Escribe un email a un cliente chileno.' }],
});

Anthropic SDK

import Anthropic from '@anthropic-ai/sdk';

const ai = new Anthropic({
  apiKey: 'esencia_sk_…',
  baseURL: 'https://gateway.appesencia.com/anthropic',
});

Llamada directa al gateway

curl -X POST https://gateway.appesencia.com/v1/humanize \
  -H "Authorization: Bearer esencia_sk_…" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Espero que este correo te encuentre bien…",
    "channel": "email",
    "packs": ["email"]
  }'

Rápido — regex deterministic. Latencia menor a 50ms. Cubre los tells obvios (frases plásticas, calcos del inglés, voseo argentino, formatos US). Sin costo de LLM secundario.

Profundo — manda el output a un LLM secundario chico (Claude Haiku por defecto) con instrucciones de tu perfil. Latencia 600-1200ms. Limpia artefactos estructurales que el modo rápido no toca.

Por defecto el modo es Rápido. Lo activas a Profundo desde el dashboard o por header en cada request.

Texto — emails, copy, propuestas, mensajes de chat, docs. Acepta .txt .md .json .csv vía drag & drop.

Código — TypeScript, JavaScript, Python, Go, Rust. Detecta comentarios obvios, naming hiperverboso, try/catch que solo re-lanza, debug leftover.

Imagen — analiza una URL pública con Vision API y/o el prompt que la generó. Detecta tells visuales (iluminación cinematográfica falsa, bokeh idéntico, AI sheen) y reescribe el prompt para regenerar más humano.

URL / Web — fetcheamos tu landing y la analizamos: prosa visible con score, tells de UI (Vercel-purple, gradients morados, lorem ipsum, UI en inglés en página español, placeholders US).

• 401 invalid_key — la API key no está, está mal formada, o está revocada. Crea una nueva en el dashboard.
• 401 expired — la key tiene fecha de expiración y ya pasó. Crea una nueva.
• 429 rate_limit — pasaste el cupo del minuto. Esperá 60s o sube de plan.
• 502 upstream_error — el proveedor de IA (OpenAI, Anthropic) está caído o respondió mal. Revisa /status.

No entrenamos modelos con tu contenido. Los logs de cada request se borran a los 30 días salvo que tu plan especifique otra cosa (Enterprise puede pedir retención extendida).

API keys: guardamos un hash PBKDF2-SHA256 con pepper server-side, no la key en texto plano. Si la pierdes, la revocas y creas una nueva — no podemos recuperarla.

Base de datos con RLS (Row Level Security) desde el día uno: cada workspace solo ve sus propios datos.