O AfiniTwin Portable se baixa do dashboard há um par de meses. Funciona: você copia o preset, cola em Claude/ChatGPT/Gemini, e a IA fala com você como se te conhecesse desde o primeiro turno. Mas copiar e colar é uma mecânica que 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.

O gesto mínimo

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 / o que seja, 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.

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/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 por compra de AfiniTwin ou por trimestral grátis do plano Profissional). Ú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. Default 10.000 requests ao mês, configurável até 1 milhão por key. Cada resposta inclui headers X-Twin-Quota-{Limit,Used,Remaining} para que sua integração saiba quanto falta.

Por que 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.

As keys são segredos no sentido forte: no DB 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.

Plano Profissional, não por capricho

A geração de keys está reservada ao plano Profissional (assinatura Stripe ativa ou voucher Profissional vivo). Os endpoints públicos servem indistintamente, desde que sua key tenha sido emitida em uma conta Profissional no momento do resgate. Se você descer de plano, as keys ficam guardadas mas os endpoints devolvem 403 até voltar a Profissional. Não as deletamos: as deixamos em pause, esperando.

Por que não Esencial ou Premium? Porque integrações B2B implicam carga sustentada na nossa infraestrutura (o snapshot vive no nosso DB, os headers vêm do nosso proxy), e o custo marginal por integração só fecha a preço Profissional. Não é restrição artificial: é engenharia honesta.

Quota, rate-limit, dois cintos

A quota mensal mede volume agregado. O rate-limit por IP/key mede rajadas. Hoje servimos 60 requests por minuto em cada endpoint pesado, 120 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.

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.

Como começar hoje

Assina ou resgata voucher Profissional em https://afini.ai/precios se ainda não tem.
Compra seu AfiniTwin desde o dashboard se ainda não fez. A API funciona sem Twin (devolve 403 NO_TWIN_PURCHASED), mas sem Twin não há muito para servir.
Gera sua primeira key em https://afini.ai/pt/dashboard/twin/api. Copia para o vault da sua integração. NÃO a commita num repo.
Chama /v1/public/twin/health para verificar que está viva. Não consome quota.
Lê 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 1M/mês, scopes específicos, suporte SLA —, escreve para info@afini.ai. Há margem de negociação.

Roadmap honesto

Hoje (v1.0): os 5 endpoints acima, scope único twin:read, plano Profissional, quota configurável até 1M.

Próximas semanas: webhooks (te notificaremos 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