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 コンテキスト上限、トークンあたり米ドル単価の取得。 |
2. 任意の予算制御・テレメトリヘッダー
X-BF16-Max-Price-Per-M-Output: 2.00— 出力単価が指定した米ドル上限を超えるエンドポイントへのルーティングを自動的に拒否します。X-BF16-Include-Cost: true— 確定した米ドル決済額をレスポンスヘッダー（X-BF16-Cost-USD）および最終 SSE usage フレームに付与します。Idempotency-Key: <uuid>— 非ストリーミングリクエストのネットワーク再試行時における二重課金を防止します。
3. ゼロプロンプト保持（0 Bytes 保存）保証
bf16.ai はリクエスト本文、システムプロンプト、モデルの出力結果をディスクやデータベースに一切保存せず、メモリ上で直接トークンをストリーミング中継します。記録されるのはトークン数、HTTP ステータスコード、および nano-USD 台帳仕訳のみです。