API vIA — desenvolvedores

Endpoints principais

GET  /health                 status (público)
GET  /version                versão vIA (público)
GET  /capabilities           capacidades (auth)
POST /predict/quick          surrogate NN (auth, <1ms warm)
POST /predict/compare        NN + GP comparativo (auth)
POST /predict/rigorous       pipeline completo (501 em β.11; γ.1 ativa)
GET  /ravs                   lista RAVs públicos (auth)
GET  /ravs/{rav_id}          detalhe + selo SHA256 (auth)
    

Autenticação

Bearer token em Authorization header. Token local lido de SECRETS/api_master_key.txt (auto-gerado no primeiro start).

curl -X POST http://127.0.0.1:8500/predict/quick \
  -H "Authorization: Bearer $(cat SECRETS/api_master_key.txt)" \
  -H "Content-Type: application/json" \
  -d '{"region":"BRA","year_start":2024,"year_end":2050}'
    

Rate limiting

• /predict/quick — 10/minuto/chave
• /predict/rigorous — 1/hora/chave
• /predict/compare — 1/hora/chave
• /ravs, /capabilities — 30/minuto/chave

Configurável em CONFIG/api_limits.yaml. Sliding window in-memory.

Diferenciação

Esta API NÃO é apenas um wrapper de LLM. Oferece:

• RAVs com selo SHA256 triplo (markdown + JSON estruturado + COMPUTE.json)
• Reproducibilidade via seed fixo (mesmo input + mesmo seed → mesmo hash)
• Auto-rejeição quando confiança epistêmica é baixa
• Conselho Popperiano — 6 especialistas científicos validam antes de emitir
• Conselho Adversarial — 5 LLMs heterogêneos como devil's advocates pós-selagem
• Memória matemática rastreável — JSON paralelo com cadeia de cálculo

Roadmap público