bf16.ai 协议与网关技术参考
bf16.ai 开发者 API 文档
将任意 OpenAI SDK、Anthropic SDK 或编码智能体指向 https://api.bf16.ai ，并携带 sk-bf16-v1-... Bearer 密钥即可直接调用。
1. 支持的原生协议端点
| 请求方法与路径 | 鉴权请求头 | 协议契约说明 |
|---|---|---|
| POST https://api.bf16.ai/v1/chat/completions | Authorization: Bearer sk-bf16-v1-... | OpenAI Chat Completions 兼容接口（支持 SSE 流式输出、reasoning_content 思维链、工具调用与 JSON Schema）。 |
| POST https://api.bf16.ai/v1/responses | Authorization: Bearer sk-bf16-v1-... | 无状态 OpenAI Responses API（强制 store: false 以严格保障零提示词留存）。 |
| POST https://api.bf16.ai/v1/messages | x-api-key 或 Bearer sk-bf16-v1-... | 原生 Anthropic Messages 协议格式，支持 HMAC 签名 thinking 思维块与 tool_use 双向转换。 |
| GET https://api.bf16.ai/v1/models | 可选 / Bearer | 实时模型目录元数据、1M 上下文窗口上限及每 Token 美元单价。 |
2. 可选预算护栏与遥测请求头
X-BF16-Max-Price-Per-M-Output: 2.00— 自动拒绝路由至任何输出单价超出您设定美元上限的上游端点。X-BF16-Include-Cost: true— 在响应头（X-BF16-Cost-USD）及最终 SSE usage 数据帧中附带本次结算美元扣费。Idempotency-Key: <uuid>— 防止非流式请求在网络超时重试时产生重复扣费。