// OVERVIEW
BYOK (Bring Your Own Key) is an AI SDK for game developers. It lets you add intelligent NPCs, dynamic dialogue, and AI-powered gameplay to any game engine — without absorbing AI costs or building infrastructure. Players fund their own AI wallets, and BYOK handles everything between your game and the AI provider: authentication, billing, safety, worldbuilding context, and player intelligence.
// ARCHITECTURE
Your game sends chat requests. BYOK authenticates, holds wallet funds, injects worldbuilding context from Spite, routes to the configured AI model, settles costs, and returns the response. Async intelligence runs after each interaction.
// DEVELOPER SIDE
// PLAYER SIDE
// WHY THIS EXISTS
The economics problem: AI inference costs scale linearly with players. A developer with 10,000 daily active players could burn thousands per month on AI alone. No indie studio can absorb that. BYOK flips the cost model — players fund their own usage at fractions of a cent per interaction.
The quality problem: Unguarded AI breaks immersion. Players jailbreak NPCs, extract system prompts, and generate off-topic content. BYOK enforces server-side system prompts, knowledge boundaries, milestone gating, and response filtering. Your narrative stays intact.
// QUICK START
# 1. Register your player (steam_id, device_id, or external_id+external_provider)
curl -X POST https://byok.gg/api/v1/users/register \
-H "Authorization: Bearer byok_sk_YOUR_KEY" \
-d '{"device_id": "my-unique-device-id"}'
# 2. Make an AI request
curl https://byok.gg/api/v1/chat/completions \
-H "Authorization: Bearer byok_sk_YOUR_KEY" \
-H "X-Byok-User: USER_ID" \
-d '{"messages": [{"role":"user","content":"Hello"}]}'Full walkthrough →