Behest Developer Documentation
Behest is AI FinOps — the platform that sits on the inference path between your app and any LLM provider, giving you real-time cost visibility, budget controls, and governance. Drop-in OpenAI SDK compatible. BYOK. No vendor lock-in.
LLMs / AI coding tools: start at llms.txt for a curated index.
Framework Quickstarts (5 minutes each)
| Doc | Description |
|---|---|
| React + Vite | SPA with streaming chat, per-user JWT |
| Next.js App Router | Route-handler mint + client streaming |
| Vercel (Edge + AI SDK) | Edge Runtime token route + optional useChat proxy |
| Supabase Edge Functions | Standalone Deno Edge Function for any frontend |
| Lovable + Supabase | Lovable.dev stack with Supabase auth |
| Modelence | Modelence module + built-in auth, one mint mutation |
| Python FastAPI | FastAPI backend using the Python SDK |
| Node + Express | Node service mint + streaming |
Guides
| Doc | Description |
|---|---|
| Auth modes | API-key mint vs local signing |
| Tiers and usage | Free/Pro/Max, /v1/billing/usage, 402 handling |
| Multi-conversation chat | Sessions + threads end-to-end |
| Streaming UI | SSE, AbortSignal, reconnect |
| Error handling | 401/402/429/5xx typed errors |
| Migrating from OpenAI | One-line change |
| Migrating from OpenRouter | One-line change |
Auth Integrations
| Provider | Doc |
|---|---|
| Supabase | supabase.md |
| Clerk | clerk.md |
| Auth0 | auth0.md |
| NextAuth | nextauth.md |
| Firebase | firebase.md |
AI-Tool Prompts
Copy-paste starters for Lovable, Cursor, Claude, and v0.
Reference
| Doc | Description |
|---|---|
| Quickstart (generic) | Tenant → project → API key → JWT (CLI walk-through) |
| Core Concepts | Tenants, projects, slugs, API keys, JWTs, BYOK, tiers |
| Authentication | API keys, JWT minting, JWKS verification, Kong headers |
SDKs & Migration
| Doc | Description |
|---|---|
| TypeScript SDK | @behest/client-ts — installation, usage, streaming, types |
| Python SDK | OpenAI Python SDK with Behest, async, REST examples |
| Migration Guide | From OpenAI/Anthropic/Portkey/Helicone to Behest |
Platform Features
| Doc | Description |
|---|---|
| Providers (BYOK) | Setup guide for OpenAI, Anthropic, Google, Mistral, Cohere, OpenRouter |
| BYOK Deep Dive | Architecture, encryption, key lifecycle, security model |
| Models | Model selection, draft/deploy, capabilities matrix, cost comparison |
| Guardrails | PII Shield, Sentinel prompt injection guard, shadow/enforce modes |
| Rate Limiting | RPM limits, token budgets, kill switches, response headers |
| Webhooks & Events | Redis Streams events, guardrail detections, budget alerts |
Reference
| Doc | Description |
|---|---|
| API Reference | Complete endpoint reference — all routes, types, examples |
| Error Reference | Error codes, HTTP status codes, handling patterns |
| Dashboard Guide | UI walkthrough — projects, settings, keys, providers, analytics |
| Troubleshooting | Common issues and solutions |