Steps

1. Create a key. Create a normal Fikra API key in the dashboard. Plan keys also work.
2. Set the endpoint. POST https://api.fikraapi.co.ke/v1/decisions with Authorization: Bearer YOUR_FIKRA_KEY.
3. Send input and questions. The body is the Google Decisions API body: input (text or content blocks) and questions. The model is fixed to gemini-decision-1.
4. Read answers. Each question returns noul, choice or score, plus probabilities and confidence. Threshold confidence before acting.
5. Price. $0.12 per 1M input tokens and $0 output. Google list price is $0.10 input.

Config

Base URL: https://api.fikraapi.co.ke/v1
API Key: YOUR_FIKRA_KEY
Model ID: deepseek-v4.1-flash-1017

Send a yes/no question about a short paragraph and check that answers.is_damaged includes noul and confidence.

Default model: deepseek-v4.1-flash-1017. Prices come from the live catalog.

Repeated prompt prefixes are billed at the cached rate. Cached input can never cost more than fresh input.

While the window is open, model deepseek-v4-1-flash-economy-free is free. Check live availability.

Troubleshooting

The Fikra key is missing or invalid. Use the fk_live_ or fk_plan_ key from the dashboard.

The upstream safety filter blocked the input. Rewrite the input and retry.

Question keys must match [A-Za-z0-9_-]+ and be at most 64 characters.