Referencia de Protocolo y Gateway de bf16.ai
Documentación de API para Desarrolladores de bf16.ai
Apunta cualquier OpenAI SDK, Anthropic SDK o agente de programación hacia https://api.bf16.ai utilizando una clave Bearer sk-bf16-v1-... para empezar al instante.
1. Endpoints Wire Soportados
| Método y Ruta | Cabecera Auth | Contrato de Protocolo |
|---|---|---|
| POST https://api.bf16.ai/v1/chat/completions | Authorization: Bearer sk-bf16-v1-... | OpenAI Chat Completions (streaming SSE, reasoning_content, tools, JSON schema). |
| POST https://api.bf16.ai/v1/responses | Authorization: Bearer sk-bf16-v1-... | OpenAI Responses API stateless (store: false obligatorio para Cero Retención de Prompts). |
| POST https://api.bf16.ai/v1/messages | x-api-key o Bearer sk-bf16-v1-... | Formato nativo Anthropic Messages con bloques thinking firmados con HMAC y traducción de tool_use. |
| GET https://api.bf16.ai/v1/models | Opcional / Bearer | Metadatos del catálogo en vivo, límites de 1M de contexto y tarifas en USD por token. |
2. Cabeceras Opcionales de Control y Telemetría
X-BF16-Max-Price-Per-M-Output: 2.00— Rechaza enrutar hacia cualquier endpoint cuya tarifa de salida supere tu techo en USD.X-BF16-Include-Cost: true— Añade el costo liquidado en USD en las cabeceras de respuesta (X-BF16-Cost-USD) y en el frame final SSE de uso.Idempotency-Key: <uuid>— Evita cargos duplicados en peticiones sin streaming ante reintentos de red.
3. Garantía de Cero Retención de Prompts
bf16.ai transmite tokens directamente en memoria sin persistir cuerpos de petición, prompts de sistema ni respuestas del modelo en disco o bases de datos. Solo se registran conteos de tokens, códigos de estado HTTP y asientos contables en nano-USD.