API Reference v1.0
Intelligence for real progress.
Fikra API is an enterprise-grade inference ecosystem. By serving as a unified proxy, we abstract the complexity of localized NPU infrastructure and multi-provider fallbacks. Integrate world-class language models using familiar SDKs, powered entirely by a transparent, localized cash wallet.
Core Architecture & Compatibility
Our infrastructure is engineered to strictly adhere to the OpenAI v1 REST specification. You only need to update your base URL and authenticate with your Fikra API Key to achieve a 100% drop-in replacement for existing pipelines.
| Specification Parameter | Production Value | Implementation Detail |
|---|---|---|
| Base URL | https://api.fikraapi.co.ke/v1 | The global endpoint for all inference routing. |
| Authentication Scheme | Authorization: Bearer | Requires active `fk_live_...` key generation. |
| SDK Compatibility | OpenAI SDK v1.0+ | Native support for Python, Node.js, Go, and REST. |
The Engine Matrix
The Fikra proxy routes your payloads automatically to the highest-performing hardware available, balancing across Groq and Alibaba endpoints via transparent fallbacks.
- fikra-flash — The system default. Ultra-fast, high-throughput routing.
- fikra-pro-20b — The balanced workhorse for agentic tasks and structured data extraction.
- fikra-pro-120b — Heavy reasoning, document synthesis, and extended logic.
- fikra-qwen-max — Deep reasoning, 1M context window, and massive chain-of-thought processing.
- fikra-auto — Autonomous routing pipelines with built-in system prompt formatting.
Decoupled Production Scaling
Fikra API employs a Redis-backed Token Bucket algorithm to decouple consumer limits from upstream hardware thresholds. Your throughput capacity (RPM) scales securely based on your account tier, shielding you from backend rate limits.
| Account Tier | Request Limit | Access Condition |
|---|---|---|
| Unverified | 30 RPM | Default sandbox evaluation state. |
| Trusted | 100 RPM | Unlocked permanently on your first wallet top-up. |
| Growth | 500 RPM | For production organizations with high concurrent traffic. |
| Scale | 2,000 RPM | High-throughput enterprise deployments. |
How do I send my first inference request?
Because we map exactly to the OpenAI spec, you do not need to learn a new library. Simply initialize the client with the Fikra base URL and your `fk_live_` key.