Cohere API Alternative: Fikra API Integration Guide

Introduction

Cohere is an external AI provider offering its own suite of language models and APIs. Fikra API is a separate platform that provides access to its own set of models (such as fikra-flash and fikra-pro-20b) through an OpenAI-compatible interface. This guide explains how to integrate with Fikra API if you are looking for an alternative integration path, without implying that Fikra hosts or resells Cohere's models.

Comparison: Cohere API vs. Fikra API

Python Example Using OpenAI SDK

Since Fikra API supports OpenAI-style requests, you can use the standard openai Python SDK by pointing the base URL to Fikra's endpoint. Ensure you have a Fikra API key stored in an environment variable.

import os
from openai import OpenAI

# Initialize the client with Fikra's base URL
client = OpenAI(
    base_url="https://api.fikraapi.co.ke/v1",
    api_key=os.getenv("FIKRA_API_KEY")
)

# Make a chat completion request
response = client.chat.completions.create(
    model="fikra-flash",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, how are you?"}
    ]
)

print(response.choices[0].message.content)

When Fikra API is a Fit

Fikra API may be a suitable choice if:

• You prefer using the OpenAI SDK and want to minimize code changes when switching providers.
• You are based in or have access to Paystack for billing, as Fikra integrates with this payment method.
• You want to use Fikra's specific model aliases (e.g., fikra-flash for speed, fikra-pro-20b for higher capability) within a familiar chat-completions structure.
• You require a token-credit wallet system for managing API usage.

Verify Before Production

Before deploying Fikra API in a production environment, please:

1. Check the Model Registry: Confirm that the specific Fikra model alias you intend to use is currently available and enabled for your account.
2. Review Rate Limits: Note that unverified accounts are limited to 30 RPM, while trusted accounts are limited to 100 RPM. Ensure your application's traffic patterns align with these limits.
3. Test Authentication: Verify that your FIKRA_API_KEY is correctly configured and that your account has sufficient token credits.
4. Validate Streaming: If you use stream: true, test the Server-Sent Events (SSE) response handling in your client application.

Note: Fikra API does not host or resell models from external providers like Cohere. All models served by Fikra are part of its own registry.