# Blackmagic AI Full Context

## What Blackmagic AI Is
Blackmagic AI is an OpenRouter-style prepaid AI API gateway. Customers buy credits, create API keys, call OpenAI-compatible routes, test text models in chat, and track usage through one billing layer.

## Current Product Direction
- Direct AI API resale through prepaid credits.
- Pay-as-you-go prepaid credits that sell 1:1 at every pack size.
- 1M credits = $1 of metered API usage.
- Builder pack: $100 = 100M credits (1M = $1), with auto-recharge and higher key limits.
- Enterprise commit: from $1,000 = 1B credits (1M = $1), with the same transparent rates.
- Margin lives in the per-model rate card, not in bonus credits; frontier coding models are priced well below provider list.
- OpenAI-compatible text routes plus selected public image routes.
- Streaming is disabled until token usage can be billed from provider usage fields.

## Public Routes
- Home: https://blackmagic.engineering/
- Models: https://blackmagic.engineering/models
- Docs: https://blackmagic.engineering/docs
- Chat: https://blackmagic.engineering/chat
- Dashboard: https://blackmagic.engineering/dashboard
- API keys: https://blackmagic.engineering/manage-api-keys
- Usage: https://blackmagic.engineering/usage
- This file: https://blackmagic.engineering/llms-full.txt

## API Routes
- POST /api/v1/chat/completions
- POST /api/v1/responses
- POST /api/v1/completions
- POST /api/v1/images/generations
- GET /api/v1/models
- GET /api/v1/key

## Featured Models
- gpt-5.5: GPT-5.5 (text, /api/v1/chat/completions)
- claude-opus-5: Claude Opus 5 (text, /api/v1/messages)
- gpt-5.6-sol: GPT-5.6 Sol (text, /api/v1/chat/completions)
- gpt-5.6-terra: GPT-5.6 Terra (text, /api/v1/chat/completions)
- gpt-5.6-luna: GPT-5.6 Luna (text, /api/v1/chat/completions)
- deepseek-v4-flash-latest: DeepSeek V4 Flash Latest (text, /api/v1/chat/completions)
- kimi-k3: Kimi K3 (text, /api/v1/chat/completions)
- nano_banana: Nano Banana (image, /api/v1/images/generations)
- gpt-image-2: GPT Image 2 (image, /api/v1/images/generations)

## Runtime Env
- ETOK_BASE_URL / ETOK_OPENAI_API_KEY
- ETOK_CLAUDE_API_KEY / ETOK_GEMINI_API_KEY
- TOAPI_BASE_URL / TOAPI_API_KEY
- Optional GATEWAY_MODEL_IDS allow-list; unknown IDs are ignored.

## Billing
- Gateway routes require a Blackmagic AI API key.
- Credits are reserved before upstream calls and settled after provider usage is known.
- Failed upstream calls refund the reserved credits.
- API-key spend limits are enforced before requests start.
- Usage logs record endpoint, method, status, latency, model, and token count.

## Boundaries
- Position the product as an OpenRouter-style prepaid AI API gateway.
- Keep the core workflow to credits, API keys, models, chat, gateway routes, and usage logs.
- Do not expose private or internal route names.
- Do not expose provider secrets.