Anunciamos a API AfiniTwin para integradores

Cinco endpoints REST autenticados com API key. Serve seu AfiniTwin como system prompt desde seu CRM, assistente próprio ou pipeline noturno. Incluído na sua assinatura afini.ai. Hoje.

I. O gesto mínimo

O AfiniTwin Portable se baixa do dashboard há um par de meses. Funciona: você copia o preset, cola em Claude, ChatGPT ou Gemini, e a IA fala com você como se te conhecesse desde o primeiro turno. Mas copiar e colar não escala. Se sua integração B2B é séria — um CRM, um assistente próprio, um pipeline noturno de processamento —, precisa de outra coisa: que o AfiniTwin entre sozinho, programaticamente, em cada chamada que seu sistema faz ao LLM.

É o que liberamos hoje. Uma API REST autenticada que serve seu AfiniTwin como system prompt, pronta para ser injetada do código que você está escrevendo.

Uma key, uma chamada:

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

Devolve o meta-prompt completo do preset que você pediu, no formato que pediu. Carrega como system no seu cliente Anthropic, OpenAI, Mistral ou qualquer outro, e a partir daí cada turno está calibrado ao seu perfil cognitivo. Sem retreinamento. Sem fine-tuning. Sem passar pela nossa infraestrutura além da leitura inicial do snapshot.

System prompt, def.: a maneira como um LLM se lembra de quem é antes de esquecer quem você é. A API B2B se encarrega de preservar-lhe a memória sobre você.

II. Cinco endpoints, uma única ideia

/v1/public/twin/health — um ping para validar que a key segue viva sem gastar quota mensal. Para seus health checks de deploy.

/v1/public/twin/me — identidade da key, plano do proprietário, quota usada e restante, último Twin disponível. O que você vai chamar ao iniciar sua integração para detectar se baixou de plano ou se a key foi revogada.

/v1/public/twin/historic — listagem dos seus snapshots, um para cada AfiniTwin que sua assinatura gera mês a mês. Útil se sua integração quer oferecer ao usuário escolher entre vários.

/v1/public/twin/snapshots/:id — metadados de um snapshot específico.

/v1/public/twin/preset/:slug?format=...&lang=...&variant=...&includeNarratives=... — o endpoint com carne. Devolve o artefato em .txt, .md, .json ou .yaml, em seis idiomas, com ou sem narrativas Opus integradas.

Todos os endpoints exceto /health contam para a quota mensal. Por padrão dez mil requests ao mês, configurável até um milhão por key. Cada resposta inclui headers X-Twin-Quota-{Limit,Used,Remaining} para que sua integração saiba quanto falta sem precisar adivinhar.

III. Por que API key, não OAuth

OAuth faria sentido se a integração fosse um terceiro acessando o perfil de um usuário diferente. Não é o caso. A API B2B serve seu AfiniTwin à sua integração — seu CRM, seu assistente, seu agente. Uma API key pessoal, gerada no seu dashboard, copiada para o vault da sua integração, é o modelo que melhor se encaixa: zero atrito de consentimento, revogação instantânea, uma key por integração para que o blast radius de um vazamento esteja limitado.

API key, def.: segredo que mantém sua condição de segredo exatamente entre a linha em que é gerado e a primeira vez em que alguém, por descuido, o cola num repositório público. Por isso a revogação é rápida.

As keys são segredos no sentido forte: no banco guardamos só o hash SHA-256, formato atk_live_<8 hex>_<32 hex>. O plaintext se mostra uma única vez ao criar. Se você perder, revoga e cria outra. Se publicar a key por acidente em um repo público — acontece, você não é o primeiro —, revoga do dashboard e sai do ar em milissegundos.

IV. Parte da sua assinatura

A geração de keys está incluída na sua assinatura afini.ai, seja por assinatura Stripe ativa ou por voucher vivo. Os endpoints públicos servem indistintamente, desde que sua key tenha sido emitida em uma conta com assinatura ativa. Se sua assinatura se interrompe, as keys ficam guardadas mas os endpoints devolvem 403 até você reativá-la. Não as deletamos: as deixamos em pause, esperando.

A API é mais uma característica da assinatura, não um extra que se compra à parte. Integrações B2B implicam carga sustentada na nossa infraestrutura — o snapshot vive no nosso banco, os headers vêm do nosso proxy — e isso já está coberto pela quota mensal. Sem letra miúda: se você está assinado, você a tem.

V. Quota e rate-limit: dois cintos

A quota mensal mede volume agregado. O rate-limit por IP e por key mede rajadas. Hoje servimos sessenta requests por minuto em cada endpoint pesado, cento e vinte por minuto em /health. Se sua integração entra em um loop infinito acidental, o rate-limit a captura antes de drenar sua quota mensal. Não é segurança de uma única camada.

Quota mensal, def.: piedade temporal que a infraestrutura concede ao integrador descuidado, expressa em requests. Renova-se no dia um; no dia dois recomeça a prova.

VI. O que NÃO somos

Isto não é um endpoint traz-me o perfil do usuário X onde X é alguém diferente do titular da key. A key autentica o proprietário e devolve sempre o seu AfiniTwin. Sem paths multi-tenant. Sem admin remoto.

Isto também não é um endpoint para treinar modelos à custa do usuário. O que servimos é o que já está no seu snapshot imutável. Se nosso provedor de inferência (Anthropic) muda sua política de retenção, não afeta retroativamente snapshots já gerados.

E isto não é substituto do journaling, do coaching nem da terapia. É um componente técnico para integradores. As questões humanas seguem sendo humanas.

VII. Como começar hoje

Assine ou resgate seu voucher em https://afini.ai/precios se ainda não fez.
Gere seu AfiniTwin desde o dashboard se ainda não tem. A API funciona sem Twin — devolve 403 NO_TWIN_PURCHASED —, mas sem Twin não há muito para servir.
Gere sua primeira key em https://afini.ai/pt/dashboard/twin/api. Copie para o vault da sua integração. Não a commite num repo.
Chame /v1/public/twin/health para verificar que está viva. Não consome quota.
Leia a documentação completa em https://afini.ai/pt/afinitwin/api. Exemplos em cURL, Node.js e Python, tabela completa de erros, recomendações de segurança.

Se seu caso de integração tem exigências particulares — quotas maiores que um milhão ao mês, scopes específicos, suporte SLA —, escreva para info@afini.ai. Há margem de negociação.

VIII. Roadmap honesto

Hoje (v1.0): os cinco endpoints acima, scope único twin:read, incluído na assinatura afini.ai, quota configurável até um milhão.

Próximas semanas: webhooks para te notificar quando um novo snapshot estiver ready — sem polling —, scope twin:write para integrações que queiram semear fatos vitais com consentimento explícito, métricas de uso desde o dashboard.

Quando for preciso: SDK oficial em TypeScript e Python, exemplos canônicos de integração com Anthropic e OpenAI, plano Enterprise com SLA e quotas acima do milhão.

Não prometemos o que não há. Se você precisa e ainda não está, diz e se prioriza.

— Ricardo