Référence Protocole & Passerelle bf16.ai
Documentation API Développeur bf16.ai
Pointez n’importe quel OpenAI SDK, Anthropic SDK ou agent de code vers https://api.bf16.ai avec une clé Bearer sk-bf16-v1-... pour démarrer immédiatement.
1. Endpoints Wire Pris en Charge
| Méthode & Chemin | En-tête Auth | Contrat de Protocole |
|---|---|---|
| POST https://api.bf16.ai/v1/chat/completions | Authorization: Bearer sk-bf16-v1-... | OpenAI Chat Completions (streaming SSE, reasoning_content, tools, schéma JSON). |
| POST https://api.bf16.ai/v1/responses | Authorization: Bearer sk-bf16-v1-... | OpenAI Responses API stateless (store: false imposé pour garantir la Zéro Rétention des Prompts). |
| POST https://api.bf16.ai/v1/messages | x-api-key ou Bearer sk-bf16-v1-... | Format wire natif Anthropic Messages avec blocs thinking signés par HMAC et traduction tool_use. |
| GET https://api.bf16.ai/v1/models | Optionnel / Bearer | Métadonnées du catalogue en direct, limites de contexte 1M et tarifs USD par token. |
2. En-têtes Optionnels de Contrôle & Télémétrie
X-BF16-Max-Price-Per-M-Output: 2.00— Refuse le routage vers tout endpoint dont le tarif de sortie dépasse votre plafond en USD.X-BF16-Include-Cost: true— Ajoute le coût réglé en USD dans les en-têtes de réponse (X-BF16-Cost-USD) ainsi que dans la trame SSE finale d’usage.Idempotency-Key: <uuid>— Empêche la double facturation des requêtes non-streaming lors des nouvelles tentatives réseau.
3. Garantie Zéro Rétention des Prompts
bf16.ai transmet les tokens directement en mémoire vive sans jamais persister les corps de requêtes, prompts système ou réponses du modèle sur disque ni en base de données. Seuls les compteurs de tokens, codes HTTP et écritures comptables en nano-USD sont journalisés.