# MapleFlow — The Everything API for Builders

> MapleFlow is one API key for AI models, identity verification, and everyday tools — priced for indie devs and small startups, not enterprise procurement. 37 AI models, face verification (~$0.014/call vs Persona $2-5), plus translate/weather/currency, all on one credit balance.

## Why MapleFlow
- One key, one balance for AI, identity verification, and everyday tools (no stitching six SaaS bills)
- Face verification at ~$0.014/call — same AWS Rekognition inside as Persona/Onfido, without enterprise pricing
- 37 AI models from 7 providers — swap models with one parameter change
- Drop-in OpenAI SDK compatible: just change `base_url` to `https://api.mapleflow.io/v1`
- Fractional credit pricing — pay per token, as low as 0.01 credits per call
- Automatic refunds — we estimate before each call and refund unused credits after
- No credit card required — 50 free credits on signup

## Pricing
- Credits start at $0.007 each (Business plan: $200 for 30,000 credits)
- A short Groq or Gemini call costs 0.01 credits (~$0.00007)
- A medium GPT-4.1-mini call costs ~1 credit (~$0.007)
- A long Claude Sonnet essay costs ~8 credits (~$0.056)
- Credits never expire. Buy once, use anytime.

## Quick Start
```python
from openai import OpenAI
client = OpenAI(api_key="sk_live_...", base_url="https://api.mapleflow.io/v1")
response = client.chat.completions.create(
    model="claude-sonnet-4.6",  # or gpt-4.1, llama-3.1-8b, gemini-2.5-flash, etc.
    messages=[{"role": "user", "content": "Hello"}]
)
```

## Available Models (30+)
Budget: llama-3.1-8b, llama-3.2-1b, gemini-2.5-flash-lite, gpt-4.1-nano, gpt-oss-20b, claude-3-haiku, phi-2, mistral-7b
Standard: gpt-4o-mini, gpt-4.1-mini, gemini-2.5-flash, llama-3.3-70b, claude-haiku-4.5, gpt-oss-120b, grok-4.1-fast
Premium: gpt-4.1, gpt-4o, o3, o3-mini, o4-mini, claude-sonnet-4, claude-sonnet-4.6, claude-opus-4.6, grok-3
Override provider: model@provider syntax (e.g., llama-3.1-8b@workers-ai)

## Additional Endpoints
- Translation: 75+ languages, auto-detection
- Image generation: Flux models
- Text-to-speech: MeloTTS
- Speech-to-text: Whisper
- Embeddings: BGE Base
- Face verification: AWS Rekognition
- Weather and currency APIs

## Compared to Alternatives
MapleFlow vs OpenRouter: Credit packages instead of credit card billing. Non-AI endpoints bundled. Official MCP server. Fractional credits with automatic refunds.
MapleFlow vs direct provider APIs: One API key instead of managing 6+ accounts. Cost-effective routing. One billing system. One response format.

## Links
- Website: https://mapleflow.io
- API Docs: https://api.mapleflow.io/docs
- Models & Pricing: https://mapleflow.io/models
- OpenAI-compatible: https://api.mapleflow.io/v1/chat/completions
- npm SDK: @mapleflow/sdk
- Python SDK: mapleflow (PyPI)
- MCP Server: @mapleflow/mcp-server (npm) or https://api.mapleflow.io/mcp (HTTP)