Referência de Protocolo e Gateway do bf16.ai
Documentação da API para Desenvolvedores bf16.ai
Aponte qualquer OpenAI SDK, Anthropic SDK ou agente de código para https://dev-api.bf16.ai usando uma chave Bearer sk-bf16-v1-... para começar imediatamente.
1. Endpoints Wire Suportados
| Método e Caminho | Header de Autenticação | Contrato de Protocolo |
|---|---|---|
| POST https://dev-api.bf16.ai/v1/chat/completions | Authorization: Bearer sk-bf16-v1-... | OpenAI Chat Completions (streaming SSE, reasoning_content, tools, JSON schema). |
| POST https://dev-api.bf16.ai/v1/responses | Authorization: Bearer sk-bf16-v1-... | OpenAI Responses API stateless (store: false imposto para Zero Retenção de Prompts). |
| POST https://dev-api.bf16.ai/v1/messages | x-api-key ou Bearer sk-bf16-v1-... | Formato wire nativo do Anthropic Messages com blocos thinking assinados via HMAC e tradução de tool_use. |
| GET https://dev-api.bf16.ai/v1/models | Opcional / Bearer | Metadados do catálogo em tempo real, limites de contexto de 1M e tarifas em USD por token. |
2. Headers Opcionais de Controle e Telemetria
X-BF16-Max-Price-Per-M-Output: 2.00— Rejeita o roteamento para qualquer endpoint cuja tarifa de saída exceda seu teto em USD.X-BF16-Include-Cost: true— Inclui o custo liquidado em USD nos headers de resposta (X-BF16-Cost-USD) e no frame final de uso SSE.Idempotency-Key: <uuid>— Evita cobranças duplicadas em chamadas sem streaming durante novas tentativas de rede.
3. Garantia de Zero Retenção de Prompts
O bf16.ai transmite tokens diretamente em memória sem persistir corpos de requisição, prompts de sistema ou respostas do modelo em disco ou bancos de dados. Apenas contagens de tokens, códigos de status HTTP e lançamentos contábeis em nano-USD são registrados.