Replicate API Alternative: Fikra API Integration Guide

Introduction

Replicate is an external platform that hosts and serves various machine learning models, including image generation and text-to-speech capabilities. It operates as a separate provider with its own model registry, pricing structure, and authentication system.

Fikra API is a distinct service that provides access to specific Fikra model aliases (such as fikra-flash and fikra-pro-20b) through an OpenAI-compatible chat-completions interface. Fikra does not host, resell, or provide Replicate's models. This guide explains how to integrate Fikra API as an alternative for developers seeking an OpenAI-style endpoint for supported Fikra models.

Comparison: Replicate vs. Fikra API

Python Example: Using Fikra API with OpenAI SDK

You can use the standard OpenAI Python SDK to interact with Fikra API by specifying the Fikra base URL and API key. Ensure you have installed the openai package.

import os
from openai import OpenAI

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

# Make a chat completion request using a Fikra model alias
response = client.chat.completions.create(
    model="fikra-flash",
    messages=[
        {"role": "user", "content": "Hello, Fikra!"}
    ]
)

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

When Fikra API is a Fit

Fikra API is a suitable choice if:

• You require an OpenAI-compatible endpoint for chat completions.
• You are looking to use specific Fikra model aliases like fikra-flash or fikra-pro-20b.
• You prefer a token-credit wallet system with Paystack billing integration (supporting M-Pesa and cards).
• You are operating in a context where the Fikra model registry aligns with your application's needs.

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 current code enforces 30 RPM for unverified accounts and 100 RPM for trusted accounts. 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. Consult Documentation: Refer to the official Fikra API documentation at https://fikraapi.co.ke for the most up-to-date information on endpoints, models, and billing.