Riferimento Protocolli e Gateway bf16.ai
Documentazione API per Sviluppatori bf16.ai
Punta qualsiasi OpenAI SDK, Anthropic SDK o agente di coding verso https://dev-api.bf16.ai utilizzando una chiave Bearer sk-bf16-v1-... per iniziare subito.
1. Endpoint Wire Supportati
| Metodo e Percorso | Header Auth | Contratto di Protocollo |
|---|---|---|
| POST https://dev-api.bf16.ai/v1/chat/completions | Authorization: Bearer sk-bf16-v1-... | OpenAI Chat Completions (streaming SSE, reasoning_content, tools, JSON schema). |
| POST https://dev-api.bf16.ai/v1/responses | Authorization: Bearer sk-bf16-v1-... | OpenAI Responses API stateless (store: false imposto per Zero Conservazione dei Prompt). |
| POST https://dev-api.bf16.ai/v1/messages | x-api-key oppure Bearer sk-bf16-v1-... | Formato wire nativo Anthropic Messages con blocchi thinking firmati HMAC e traduzione tool_use. |
| GET https://dev-api.bf16.ai/v1/models | Opzionale / Bearer | Metadati live del catalogo, limiti di contesto 1M e tariffe USD per token. |
2. Header Opzionali di Controllo e Telemetria
X-BF16-Max-Price-Per-M-Output: 2.00— Rifiuta l’instradamento verso qualsiasi endpoint la cui tariffa di output superi il tetto USD impostato.X-BF16-Include-Cost: true— Aggiunge il costo liquidato in USD negli header di risposta (X-BF16-Cost-USD) e nel frame SSE finale di utilizzo.Idempotency-Key: <uuid>— Previene addebiti duplicati nelle richieste non-streaming durante i tentativi di rete.
3. Garanzia di Zero Conservazione dei Prompt
bf16.ai trasmette i token direttamente in memoria senza salvare corpi delle richieste, prompt di sistema o completamenti su disco o database. Vengono registrati solo i conteggi dei token, i codici di stato HTTP e le scritture contabili in nano-USD.