Anunciamos la API AfiniTwin para integradores

Cinco endpoints REST autenticados con API key. Sirve tu AfiniTwin como system prompt desde tu CRM, asistente propio o pipeline nocturno. Incluido en tu suscripción afini.ai. Hoy.

I. El gesto mínimo

El AfiniTwin Portable lleva un par de meses descargándose desde el dashboard. Funciona: copias el preset, lo pegas en Claude, ChatGPT o Gemini, y la IA habla contigo como si te conociera desde el primer turno. Copiar y pegar, sin embargo, es una mecánica que no escala. Si tu integración B2B es seria —un CRM, un asistente propio, un pipeline nocturno de procesamiento— necesitas otra cosa: que el AfiniTwin entre solo, programáticamente, en cada llamada que hace tu sistema al LLM.

Eso es lo que liberamos hoy. Una API REST autenticada que sirve tu AfiniTwin como system prompt, lista para inyectarse desde el código que estés escribiendo.

Una key, una llamada:

curl -H "X-Twin-Key: atk_live_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy" \
  "https://api.afini.ai/v1/public/twin/preset/estandar?format=json&lang=es"

Devuelve el meta-prompt completo del preset que pidas, en el formato que pidas. Lo cargas como system en tu cliente Anthropic, OpenAI, Mistral o el que sea, y a partir de ahí cada turno está calibrado a tu perfil cognitivo. Sin reentrenamiento. Sin fine-tuning. Sin pasar por nuestra infraestructura más allá de la lectura inicial del snapshot.

System prompt, def.: el modo en que un LLM se acuerda de quién es antes de olvidarse de quién eres tú. La API B2B se ocupa de mantenerle la memoria.

II. Cinco endpoints, una sola idea

/v1/public/twin/health — un ping para validar que la key sigue viva sin gastar cuota mensual. Para tus health checks de despliegue.

/v1/public/twin/me — identidad de la key, plan del propietario, cuota usada y restante, último Twin disponible. Es lo que llamarás al arrancar tu integración para detectar si has bajado de plan o si la key fue revocada.

/v1/public/twin/historic — listado de tus snapshots, uno por cada AfiniTwin que tu suscripción genera mes a mes. Útil si tu integración quiere ofrecer al usuario elegir entre varios.

/v1/public/twin/snapshots/:id — metadatos de un snapshot concreto.

/v1/public/twin/preset/:slug?format=...&lang=...&variant=...&includeNarratives=... — el endpoint con carne. Devuelve el artefacto en .txt, .md, .json o .yaml, en seis idiomas, con o sin narrativas Opus integradas.

Todos los endpoints excepto /health cuentan para la cuota mensual. Por defecto diez mil requests al mes, configurable hasta un millón por key. Cada respuesta incluye cabeceras X-Twin-Quota-{Limit,Used,Remaining} para que tu integración sepa cuánto le queda sin necesidad de adivinar.

III. Por qué API key, no OAuth

OAuth tendría sentido si la integración fuese un tercero accediendo al perfil de un usuario distinto. No es el caso. La API B2B sirve tu AfiniTwin a tu integración —tu CRM, tu asistente, tu agente—. Una API key personal, generada en tu dashboard, copiada al vault de tu integración, es el modelo que mejor encaja: cero fricción de consentimiento, revocación instantánea, una key por integración para que el blast radius de una filtración esté acotado.

API key, def.: secreto que mantiene su condición de secreto exactamente entre la línea en la que se genera y la primera vez que alguien la pega, por descuido, en un repositorio público. Por eso se revoca rápido.

Las keys son secretos en el sentido fuerte: en base de datos guardamos solo el hash SHA-256, formato atk_live_<8 hex>_<32 hex>. El plaintext se enseña una vez al crearla. Si lo pierdes, revocas y creas otra. Si publicas la key por accidente en un repo público —pasa, no eres el primero— la revocas desde el dashboard y sale del aire en milisegundos.

IV. Parte de tu suscripción

La generación de keys está incluida en tu suscripción afini.ai, ya sea por suscripción Stripe activa o por voucher vivo. Los endpoints públicos sirven indistintamente, siempre que tu key venga firmada en una cuenta con suscripción activa. Si tu suscripción se cancela, las keys siguen guardadas pero los endpoints devuelven 403 hasta que la reactives. No las borramos: las dejamos en pausa, esperando.

La API es una característica más de la suscripción, no un extra que se compre aparte. Las integraciones B2B implican carga sostenida sobre nuestra infraestructura —el snapshot vive en nuestra base de datos, las cabeceras se sirven desde nuestro proxy—, y eso ya está cubierto por la cuota mensual. No hay letra pequeña: si estás suscrito, la tienes.

V. Cuota y rate-limit: dos cinturones

La cuota mensual mide volumen agregado. El rate-limit por IP y por key mide ráfagas. Hoy te servimos sesenta requests por minuto sobre cada endpoint pesado, ciento veinte por minuto sobre /health. Si tu integración pega un bucle infinito accidental, el rate-limit la atrapa antes de drenarte la cuota mensual. No es seguridad de una sola capa.

Cuota mensual, def.: piedad temporal que la infraestructura concede al integrador descuidado, expresada en requests. Se renueva el día uno; el día dos vuelve a empezar la prueba.

VI. Lo que NO somos

Esto no es un endpoint de tráeme el perfil del usuario X donde X es alguien distinto al titular de la key. La key autentica al propietario y devuelve siempre su AfiniTwin. No hay paths multi-tenant. No hay admin remoto.

Esto tampoco es un endpoint para entrenar modelos a costa del usuario. Lo que servimos es lo que ya está en su snapshot inmutable. Si nuestro proveedor de inferencia (Anthropic) cambia su política de retención, no afecta retroactivamente a snapshots ya generados.

Y esto no es un sustituto del journaling, del coaching ni de la terapia. Es un componente técnico para integradores. Las cuestiones humanas siguen siendo humanas.

VII. Cómo empezar hoy

1. Suscríbete o canjea tu voucher en https://afini.ai/precios si aún no lo has hecho.
2. Genera tu AfiniTwin desde el dashboard si no lo tienes todavía. La API funciona sin Twin —te devuelve 403 NO_TWIN_PURCHASED—, pero sin Twin no hay mucho que servir.
3. Genera tu primera key en https://afini.ai/es/dashboard/twin/api. Cópiala al vault de tu integración. No la cometas a un repo.
4. Llama a /v1/public/twin/health para verificar que está viva. No consume cuota.
5. Lee la documentación completa en https://afini.ai/es/afinitwin/api. Hay ejemplos en cURL, Node.js y Python, tabla completa de errores y recomendaciones de seguridad.

Si tu caso de integración tiene exigencias particulares —cuotas mayores que un millón al mes, scopes específicos, soporte SLA—, escríbenos a info@afini.ai. Hay margen de negociación.

VIII. Roadmap honesto

Hoy (v1.0): los cinco endpoints anteriores, scope twin:read único, incluido en la suscripción afini.ai, cuota configurable hasta un millón.

Próximas semanas: webhooks para notificarte cuando un nuevo snapshot esté ready —sin que tengas que hacer polling—, scope twin:write para integraciones que quieran sembrar hechos vitales con consentimiento explícito, métricas de uso desde el dashboard.

Cuando haga falta: SDK oficial en TypeScript y Python, ejemplos canónicos de integración con Anthropic y OpenAI, plan Enterprise con SLA y cuotas por encima del millón.

No prometemos lo que no hay. Si lo necesitas y aún no está, dilo y se prioriza.

— Ricardo