GRUPPO B10 · DEVELOPER

QSE API

Endpoint AI con License Key B10, fingerprint deterministico e cache server-side. A parità di modello, istruzioni, input e stato dichiarato, il gateway restituisce la risposta già calcolata senza una nuova chiamata al provider.

ENDPOINT

POST /api/qse/v1/responses

Autenticazione tramite X-B10-API-Key oppure Authorization: Bearer.

POST /api/qse/v1/responses
X-B10-API-Key: iw_live_...

{
  "input": "Analizza questo testo...",
  "system": "Rispondi in italiano.",
  "model": "gpt-6-luna",
  "stateKey": "customer-42",
  "stateHash": "v7"
}

RISPOSTA

Usage misurabile

La risposta espone il fingerprint QSE, l'esito cache hit/miss e i token riportati dal provider per la chiamata effettivamente eseguita.

{
  "outputText": "...",
  "model": "gpt-6-luna",
  "qseCacheHit": true,
  "fingerprint": "...",
  "usage": {
    "inputTokens": 0,
    "cachedInputTokens": 0,
    "outputTokens": 0
  }
}

STATE

Delta controllabile

stateKey e stateHash fanno parte del fingerprint. Quando lo stato applicativo non cambia, puoi riusare in modo deterministico una risposta già prodotta. Quando cambia, cambia anche il fingerprint.

LICENSING

Una chiave, una scadenza

La stessa B10 API key è anche la licenza del servizio. Alla scadenza il gateway risponde con HTTP 402 senza inoltrare la richiesta al provider AI.