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 engine matrix lists every chat model published on GET /v1/models. This table is generated live from the model registry — it always matches the API. Rates are USD per 1M tokens; every model includes automatic high-availability routing behind Fikra.

Model Best for Input / 1M Output / 1M Context
deepseek-v4.1-flash $ 0.25 $ 0.8 1,048,576 tok
deepseek-v4.1-flash-1017 The latest DeepSeek V4.1 Flash update (Oct 17 build): better reasoning, coding, agentic and $ 0.3 $ 0.85 1,048,576 tok
deepseek-v4-flash-0731 $ 0.09 $ 0.15 1,048,576 tok
fikra-free-deepseek Free tier flagship. Runs the latest DeepSeek flash build with 1M context; zero billing. High $ 0.0 $ 0.0 1,048,576 tok
glm-5.3-flash $ 0.25 $ 0.7 327,680 tok
kimi-k3 $ 3.85 $ 19.25 1,048,576 tok
step-5-preview $ 1.25 $ 3.3 1,048,576 tok
mimo-v2.6-pro Xiaomi MiMo-V2.6-Pro: the top-scoring open-weight model on the Artificial Analysis index rig $ 0.6 $ 1.2 1,048,576 tok
qwen3.8-27b Fast 27B-class multimodal model with automatic prompt caching. Pay $0.10/M on cached input. $ 0.4 $ 0.4 1,001,536 tok
gemini-4-argon $ 2.5 $ 12.0 1,048,576 tok
nvidia-nemotron-3.5-super-vl $ 0.5 $ 1.25 1,048,576 tok
glm-5.3 Z.ai flagship GLM-5.3: large-scale reasoning for complex software engineering and long-horiz $ 1.2 $ 5.5 1,048,576 tok
glm-5.2 Z.ai GLM-5.2 on a 1M context: strong coding and reasoning at a lower price than GLM-5.3. The $ 1.0 $ 3.2 1,048,576 tok
fikra-pro-20b $ 0.2 $ 0.2 131,072 tok
fikra-pro-120b $ 0.3 $ 0.3 131,072 tok
fikra-qwen-27b $ 0.4 $ 0.4 262,144 tok
fikra-qwen-max $ 6.0 $ 12.0 1,048,576 tok
fikra-auto $ 0.4 $ 0.4 262,144 tok
fikra-auto-pro $ 6.0 $ 12.0 1,048,576 tok
fikra-code-35b $ 1.0 $ 1.0 262,144 tok

Speech and text utilities ship as separate endpoints: fikra-embed (embeddings, $0.05/1M tokens), fikra-stt (transcription, $0.001/min) and fikra-tts (speech, $25/1M characters).

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 · 300 req/day Default free-evaluation state. Tokens: 100,000 TPM · 1,000,000 TPD.
Trusted 1000 RPM · 20,000 req/day Unlocked permanently on your first wallet top-up. Tokens: 2,000,000 TPM · 50,000,000 TPD.

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.

Python (Streaming Example)
import openai import os client = openai.OpenAI( base_url="https://api.fikraapi.co.ke/v1", api_key=os.getenv("FIKRA_API_KEY") ) response = client.chat.completions.create( model="fikra-pro-20b", messages=[ {"role": "system", "content": "You are a helpful engineering assistant."}, {"role": "user", "content": "Hello, Fikra!"} ], stream=True ) for chunk in response: if chunk.choices[0].delta.content is not None: print(chunk.choices[0].delta.content, end="")

Next Steps

Authentication Guide →

Deep dive into securing your keys and environment configuration.

Developer Hub

Go to Dashboard ↗

Generate your keys, upgrade your tier, and monitor live usage.