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 스키마 지원). |
| 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-... | HMAC 서명 thinking 블록 및 tool_use 변환을 지원하는 네이티브 Anthropic Messages 와이어 포맷. |
| GET https://dev-api.bf16.ai/v1/models | 선택 / Bearer | 실시간 모델 카탈로그 메타데이터, 1M 컨텍스트 한도 및 토큰당 USD 단가. |
2. 선택적 예산 제어 및 텔레메트리 헤더
X-BF16-Max-Price-Per-M-Output: 2.00— 출력 단가가 지정한 USD 상한선을 초과하는 엔드포인트로의 라우팅을 거부합니다.X-BF16-Include-Cost: true— 정산된 USD 비용을 응답 헤더(X-BF16-Cost-USD)와 마지막 SSE usage 프레임에 포함합니다.Idempotency-Key: <uuid>— 비스트리밍 요청의 네트워크 재시도 시 중복 과금을 방지합니다.