How does billing and token tracking work?
Fikra API uses a predictable pay-as-you-go billing model. Your account maintains a credit balance that can be funded through supported payment methods. API usage consumes credits according to the pricing of the model you use.
Token Economics
Fikra API uses model-specific token pricing rather than a single universal rate. Different models have different computational characteristics and therefore different prices. The current authoritative pricing for available models is published in the Model Registry.
| Pricing Tier | Current Models | Price per 1M Tokens (USD) |
|---|---|---|
| Base | fikra-flash, fikra-fast-8b | $0.50 |
| General | fikra-pro-20b, fikra-auto | $2.00 |
| Heavy Synthesis | fikra-pro-120b | $3.00 |
| Deep Reasoning | fikra-qwen-max, fikra-auto-pro | $5.00 |
Fikra API pricing can change as models and infrastructure evolve. The Model Registry is the authoritative reference for current model availability and pricing. Check the registry before making production cost assumptions.
Account Credits & Usage
Fikra API separates payment funding from model usage. You add funds to your account and those funds become available as account credits. As requests are processed, the corresponding usage cost is deducted from your available balance.
The Billing Lifecycle
- Add funds to your Fikra API account using a supported payment method.
- Your account receives the corresponding billing credit.
- API requests consume credits according to the selected model's published pricing.
- Your remaining balance is reflected in your account and billing information.
- If your available balance is exhausted, API requests requiring additional paid usage will be rejected until the account is funded again.
Billing is separate from model selection
You can use different Fikra models from the same account. The amount consumed depends on the pricing associated with the model handling the request. Switching models therefore changes the cost of subsequent usage, while your account and billing balance remain the same.
Payments
Fikra API uses Paystack to process account payments. This allows customers to fund their accounts using locally relevant payment methods as well as other payment methods supported by Paystack.
Supported Payment Infrastructure
- 01 Paystack handles payment processing and transaction confirmation.
- 02 M-Pesa is supported for customers who prefer mobile-money payments.
- 03 Additional payment methods may be introduced as Fikra expands its payment infrastructure.
Payment processing is handled securely through the payment infrastructure provided by Paystack. Fikra does not require customers to expose payment credentials to the Fikra inference API itself.
Adding Funds
Account funding is performed through the Fikra billing experience. When a payment is successfully completed, the corresponding amount is applied to the customer's account balance.
Typical Top-Up Flow
- Open the billing section of your Developer Dashboard .
- Select the amount you want to add to your account.
- Choose a supported payment method and complete the payment through the secure payment interface.
- Once the transaction is confirmed, the funds are reflected in your Fikra account.
- You can then continue making API requests against your available balance.
The minimum account funding amount is $1 USD or the applicable local-currency equivalent.
Growth & Scale Plans
Fikra API offers Growth and Scale plans for organizations that need higher capacity and a more structured platform relationship. These plans are separate from model inference charges: the platform plan provides capacity and service commitments, while API usage continues to be billed according to the applicable model pricing.
| Plan | Monthly Platform Fee | Capacity |
|---|---|---|
| Growth | KES 6,500 / month | Higher-capacity API access and dedicated platform support. |
| Scale | KES 18,000 / month | Higher-capacity access with increased throughput and service commitments. |
Platform fees are not token credits
A Growth or Scale subscription does not automatically convert its monthly platform fee into inference credits. Model usage remains subject to the applicable token pricing and account billing balance.
Automatic Recharge
Fikra API can support automatic account funding for eligible payment methods. When enabled, automatic recharge can help maintain service continuity when an account approaches its configured balance threshold.
Availability
Automatic recharge availability depends on the payment method and account configuration. Payment credentials are handled through the payment provider, rather than being exposed to the Fikra inference API.
When Your Balance Runs Out
Paid API requests require sufficient account balance. When your available balance
is insufficient for continued usage, Fikra API returns
402 Payment Required.
Payment Required
Your Fikra account does not have sufficient available balance to process the requested paid usage. Add funds to your account and retry the request.
Pricing Guidance
Model pricing is maintained independently from this billing overview because Fikra's model catalogue evolves over time. For production applications, always use the Model Registry as the current reference for model names, availability, and pricing.
Keep these concepts separate
- • Payment is how you add funds to your account.
- • Account balance represents the funds available for paid usage.
- • Token pricing determines how much model usage consumes from your balance.
- • Platform plans such as Growth and Scale provide additional capacity and service commitments separately from inference usage.