# MANSA ROUTER — Universal Frontier AI Gateway

> Universal OpenAI-compatible API gateway providing instant, low-latency access to the world's leading frontier AI models (Claude Sonnet 5.5, GPT-6 Sol, DeepSeek V4.1, Gemini 3.8 Flash, Llama 4 Scout, Mistral Large 4) with local pan-African Mobile Money (Wave, Orange Money, MTN, Moov) and international card billing at 0% token markup.

## Core API Specification
- Base URL: `https://mansa-router.com/v1`
- Alternative Base URL (Direct): `https://mansa-router.com`
- Protocol: 100% drop-in replacement for OpenAI API specification (Chat Completions & Embeddings)
- Authentication: `Bearer <MANSA_API_KEY>`
- Primary Endpoints:
  - `POST https://mansa-router.com/v1/chat/completions` (Chat completions with SSE streaming)
  - `POST https://mansa-router.com/v1/embeddings` (High-density vector embeddings for RAG)
  - `GET https://mansa-router.com/v1/models` (Live listing of all accessible models)

## Key Value Propositions
1. Zero Token Markup: Billed strictly at official upstream lab pricing with 0% gross margin on tokens.
2. Local & Universal Payments: Instant deposits from 500 XOF (~$0.80 USD) via Wave, Orange Money, MTN MoMo, Moov Flooz, and Visa / Mastercard. No monthly commitments or forced subscriptions.
3. Drop-in Compatibility: Works immediately with Cursor IDE, Windsurf, Cline, OpenCode, n8n, LangChain, LlamaIndex, Python OpenAI SDK, and TypeScript OpenAI SDK.
4. Zero Disk Retention: In-memory ephemeral proxying over TLS 1.3. Prompts and responses are never stored, logged to disk, or reused for AI model training.

## Popular Models & Transparent Pricing (0% Token Markup)
Prices are per 1 Million (1M) tokens. Billed in CFA Francs (XOF) and USD at exact official lab rates:

| Model ID | Provider | Context | Input Cost | Output Cost | Best For |
|---|---|---|---|---|---|
| `anthropic/claude-opus-5.5` | Anthropic | 1M tokens | $4.00 (2 400 XOF) | $20.00 (12 000 XOF) | Elite coding, giant codebase refactoring |
| `anthropic/claude-sonnet-5.5` | Anthropic | 1M tokens | $2.00 (1 200 XOF) | $10.00 (6 000 XOF) | Coding, agents, hybrid reasoning |
| `anthropic/claude-haiku-5.5` | Anthropic | 1M tokens | $0.10 (60 XOF) | $0.50 (300 XOF) | Ultra-fast sub-agents, classification |
| `openai/gpt-6-astra` | OpenAI | 1.1M tokens | $10.00 (6 000 XOF) | $50.00 (30 000 XOF) | SOTA CoT reasoning, STEM, formal logic |
| `openai/gpt-6-sol-pro` | OpenAI | 1.1M tokens | $2.00 (1 200 XOF) | $10.00 (6 000 XOF) | Omnimodal, architecture & engineering |
| `deepseek/deepseek-v4.1-flash` | DeepSeek AI | 1.0M tokens | $0.30 (180 XOF) | $1.20 (720 XOF) | Ultra low-cost chatbots & rapid coding |
| `deepseek/deepseek-v4-pro-0813` | DeepSeek AI | 1.0M tokens | $0.66 (396 XOF) | $1.98 (1 188 XOF) | In-depth reasoning & software engineering |
| `deepseek/deepseek-r1-0528` | DeepSeek AI | 163k tokens | $0.50 (300 XOF) | $2.15 (1 290 XOF) | Open-weights reasoning (R1) |
| `google/gemini-3.8-flash` | Google DeepMind | 1.0M tokens | $0.75 (450 XOF) | $3.75 (2 250 XOF) | Fast multimodal, OCR, 1M context |
| `meta-llama/llama-4-scout` | Meta AI | 1.3M tokens | $0.10 (60 XOF) | $0.30 (180 XOF) | Giant 1.3M context, open SOTA for RAG |
| `mistralai/mistral-large-4-0` | Mistral AI | 1.0M tokens | $0.68 (408 XOF) | $2.09 (1 254 XOF) | Sovereign European AI & GDPR compliance |
| `code-max` (or `smart-code`) | Smart Alias | 1M tokens | $2.00 (1 200 XOF) | $10.00 (6 000 XOF) | Auto-routes to Claude Opus/Sonnet 5.5 |
| `eco-fast` (or `smart-fast`) | Smart Alias | 1M tokens | $0.10 (60 XOF) | $0.50 (300 XOF) | Auto-routes to fastest cheap model |

## Quickstart Examples

### cURL
```bash
curl https://mansa-router.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MANSA_API_KEY" \
  -d '{
    "model": "anthropic/claude-sonnet-5.5",
    "messages": [{"role": "user", "content": "Explain quantum entanglement in 2 sentences."}]
  }'
```

### Python (OpenAI SDK)
```python
from openai import OpenAI

client = OpenAI(
    base_url="https://mansa-router.com/v1",
    api_key="mansa-sk-live-..."
)

response = client.chat.completions.create(
    model="deepseek/deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Write a fast Fibonacci function in Rust."}]
)
print(response.choices[0].message.content)
```

### TypeScript / Node.js
```typescript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://mansa-router.com/v1",
  apiKey: process.env.MANSA_API_KEY,
});

const response = await client.chat.completions.create({
  model: "google/gemini-3.8-flash",
  messages: [{ role: "user", content: "Summarize this article." }],
});
console.log(response.choices[0].message.content);
```

### Cursor IDE Configuration
1. Open Cursor Settings -> Models.
2. Enable "OpenAI API Key" and paste your Mansa API Key (`mansa-sk-live-...`).
3. Under "OpenAI Base URL", enter: `https://mansa-router.com/v1`.
4. Add your preferred model IDs: `anthropic/claude-sonnet-5.5`, `deepseek/deepseek-v4.1-flash`, `code-max`, etc.

## Enterprise & SMB AI Assistants (Mansa Studio)
- Turnkey zero-hallucination RAG assistants for clinics, schools, retail stores, hotels, real estate, and African SMBs.
- Channels: 1-line Shadow DOM web widget (`widget.js`), public hosted link (`/a/:slug`), printable HD QR Code counter poster, and integrated WhatsApp/Email Lead CRM.
- Enterprise Solutions Page: `https://mansa-router.com/solutions/entreprises`

## Documentation & Links
- [Enterprise & SMB AI Solutions](https://mansa-router.com/solutions/entreprises): No-code RAG chatbots, printable QR Code counter posters, and WhatsApp lead capture for businesses.
- [Aether 3D Foundry](https://mansa-router.com/studio-3d): AI-directed photorealistic 3D commercials with Blender Cycles & Remotion.
- [Full LLM Specification & Catalog](https://mansa-router.com/llms-full.txt): Detailed catalog, context windows, and exact per-token rates.
- [Models Catalog](https://mansa-router.com/models): Interactive browser of all models and smart aliases.
- [Pricing & Token Rates](https://mansa-router.com/pricing): Token prices in CFA Francs (XOF) and USD with real-time deposit calculator.
- [Engineering Tutorials & Guides](https://mansa-router.com/guides): Step-by-step guides for Cursor IDE, Mobile Money payments, and cost reduction.
- [Developer Documentation](https://mansa-router.com/docs): Complete integration documentation for IDEs and frameworks.
- [Transparency & Security Charter](https://mansa-router.com/transparency): Technical audit, zero retention guarantee, and SLA metrics.
- [Assistance & FAQ](https://mansa-router.com/assistance): Comprehensive support and answers to common inquiries.
- [Get an API Key](https://mansa-router.com/auth/register): Instant developer signup.