bf16.ai 協定與閘道技術參考
bf16.ai 開發者 API 文件
將任意 OpenAI SDK、Anthropic SDK 或開發代理指向 https://dev-api.bf16.ai ，並搭配 sk-bf16-v1-... Bearer 金鑰即可直接串接。
1. 支援的原生傳輸端點
| 方法與路徑 | 驗證標頭 | 協定規格說明 |
|---|---|---|
| POST https://dev-api.bf16.ai/v1/chat/completions | Authorization: Bearer sk-bf16-v1-... | OpenAI Chat Completions 相容端點（支援 SSE 串流、reasoning_content 推理鏈、工具呼叫與 JSON Schema）。 |
| POST https://dev-api.bf16.ai/v1/responses | Authorization: Bearer sk-bf16-v1-... | 無狀態 OpenAI Responses API（強制套用 store: false 以嚴格落實零提示詞留存）。 |
| POST https://dev-api.bf16.ai/v1/messages | x-api-key 或 Bearer sk-bf16-v1-... | 原生 Anthropic Messages 傳輸格式，支援 HMAC 簽章 thinking 區塊與 tool_use 雙向轉換。 |
| GET https://dev-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>— 防止非串流請求於網路重試期間產生重複扣款。