Roteamento inteligente. Respostas sempre.
Uma única API. Múltiplos provedores. O melhor modelo, automaticamente.
| Provedor | Variáveis necessárias |
|---|
Simula a escolha por saúde, disponibilidade e capacidade sem consumir chamadas de IA.
Fallback inteligente: a ordem é dinâmica e muda conforme o desempenho observado. OpenAI paga é reserva penúltima quando habilitada; Persi AI (VPS) é sempre a última.
Persi Intelligence
Configuração administrativa. Instruções existentes preservadas. Autonomia e voz dependem das ferramentas efetivamente habilitadas no servidor.
Exclusivas do chat administrativo. Não afetam atendentes dos projetos.
Instruções extras enviadas à Persi IA em toda conversa. Não substituem permissões reais do backend.
Compressão corta o histórico antigo e limpa espaços. Caveman condensa as mensagens antigas (as 4 últimas ficam intactas).
Permissões propostas. Funções de intervenção automática permanecem inativas até integração e validação do executor seguro.
Conversa por voz disponível na aba Conversar. Voz neural depende de suporte do modelo e de franquia gratuita; caso indisponível, a voz do navegador é utilizada.
Regras persistidas. Alertas automáticos dependem de telemetria disponível.
Cada projeto (site, app, WhatsApp) tem sua própria chave de API e suas próprias instruções pra Persi IA — não precisa ser tudo igual. Cole a chave dele no lugar da PERSI_MASTER_KEY no projeto (ela não tem acesso a esse painel, só ao chat).
Pacote = conjunto de módulos liberados ao cliente. No projeto você escolhe o pacote e pode liberar ou tirar módulos avulsos. A mudança vale no próximo login do cliente.
Chave informada aqui é salva no Cloudflare KV (armazenamento do próprio Worker) e passa a ter prioridade sobre .dev.vars/secret. Não precisa editar arquivo nem reiniciar o servidor.
Balanceamento de carga: cole várias chaves separadas por vírgula no mesmo campo (ex: chave1,chave2,chave3) pra usar várias contas do mesmo provedor. A cada requisição o roteador sorteia uma. Na Cloudflare, coloque a mesma quantidade de valores em CF_ACCOUNT_ID e CF_API_TOKEN, na mesma ordem.
Últimas requisições (fica salvo no KV, limite de 200 entradas).
| Quando | Provedor | Modelo | Status | Latência | Tokens |
|---|
Histórico de até 90 dias, por projeto e por provedor. Os números refletem tokens informados pelas APIs, não o saldo externo das contas.
| Projeto | Entrada | Saída | Total | Requisições |
|---|---|---|---|---|
| Carregando... | ||||
Defina tetos globais e por projeto. Após atingir o limite registrado, novas chamadas são bloqueadas antes da IA. Zero = ilimitado. Chamadas simultâneas podem ultrapassar o teto por causa da propagação do Cloudflare KV.
Mostra apenas referências publicadas, não o saldo real das contas. Cada modelo pode ter sua própria cota, mas modelos de um provedor também podem compartilhar limites. Requisições, tokens, Neurons e custo não são unidades intercambiáveis. O dia do histórico da Persi Router é Brasília; os provedores têm horários próprios de reinício.
| Provedor / Modelo | Tokens por dia | Outras cotas publicadas | Situação | Fonte |
|---|
Base URL: http://127.0.0.1:8787 (local). Em produção vira uma URL pública do tipo https://persi-router.SEU-SUBDOMINIO.workers.dev.
Autenticação: header Authorization: Bearer SUA_PERSI_MASTER_KEY em toda chamada, exceto /health.
| Rota | Método | Uso |
|---|---|---|
/health | GET | Checagem simples, sem autenticação |
/v1/models | GET | Lista provedores configurados e disponíveis |
/v1/chat/completions | POST | Envia mensagens, recebe resposta da IA |
/v1/images/generations | POST | Gera uma imagem a partir de um texto ({"prompt":"..."}); devolve data[0].b64_json |
/v1/memory | GET / DELETE | Lista ou apaga tudo da memória do cliente (dono da chave) |
/v1/memory/:id | DELETE | Apaga um fato da memória |
Ferramentas (opcional): envie "tools":"auto" em /v1/chat/completions para a IA abrir sites (fetch_url) e, se houver chave de pesquisa, pesquisar na web (web_search). Máximo de 4 usos e 25 s por pedido; a resposta traz sources com as páginas lidas. Sem tools, nada muda.
Memória por cliente (opcional): envie "memory":"auto" em /v1/chat/completions. A IA pode anotar fatos curtos (até 50 por cliente, 200 caracteres cada, válidos por 180 dias) e usá-los nas próximas conversas. Senhas, chaves, documentos e cartões não são guardados. Cada projeto só enxerga a própria memória, e ela pode ser apagada por DELETE /v1/memory.
Pesquisa na web: usa a chave BRAVE_API_KEY se existir; senão usa a chave Gemini que a Router já tem (com busca do Google).
Variáveis: PERSI_TOOL_DAILY_LIMIT (usos de ferramenta por dia por chave, padrão 50), PERSI_IMAGE_DAILY_LIMIT (imagens por dia por chave, padrão 20), BRAVE_API_KEY (secret da pesquisa na web; sem ela só fetch_url funciona). A geração de imagem exige o binding AI do Workers AI.
Formato compatível com a API da OpenAI — qualquer SDK que já fale com ela funciona trocando só a URL base.
curl http://127.0.0.1:8787/v1/chat/completions \
-H "Authorization: Bearer SUA_PERSI_MASTER_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Olá"}]}'
model aceita "auto" (fallback automático) ou "provedor/modelo" pra forçar um específico, ex.: "groq/openai/gpt-oss-120b".