API Overview
100% OpenAI-Compatible Use any OpenAI-compatible client with Korad.AI.
Base URL​
Production​
https://api.korad.ai/v1
Development​
http://localhost:8084/v1
Authentication​
Use your Virtual Key in the x-bf-vk header:
curl -X POST https://api.korad.ai/v1/chat/completions \
-H "x-bf-vk: sk-bf-YOUR_VIRTUAL_KEY" \
-d '{...}'
Compatibility​
The Korad.AI API is 100% OpenAI-Compatible. You can use it with:
- ✅ OpenAI Python/JavaScript SDKs
- ✅ LangChain
- ✅ LlamaIndex
- ✅ Anthropic Python SDK (with base_url override)
- ✅ Any HTTP client
Core Endpoints​
| Endpoint | Method | Description |
|---|---|---|
/chat/completions | POST | Create chat completions |
/models | GET | List available models |
/health | GET | Health check |
Response Format​
All responses include optimization headers:
HTTP/1.1 200 OK
Content-Type: application/json
X-Korad-Original-Tokens: 50000
X-Korad-Optimized-Tokens: 5000
X-Korad-Savings-USD: $0.014250
X-Korad-Strategy: Recursive-RLM (controller: claude-haiku-4-5-20251001)
Next Steps​
- Request Headers - Control optimization behavior
- Chat Completions - Create completions
- Models - Available models
- Errors - Error handling