README.md

# TokenMix — One API Key, Every LLM

Access **GPT-5, Claude, Gemini, DeepSeek, Qwen** and **155+ other LLMs** through a single OpenAI-compatible API with consolidated billing.

🌐 **Website**: [tokenmix.ai](https://tokenmix.ai)
📖 **Docs**: [tokenmix.ai/docs](https://tokenmix.ai/docs)
💻 **GitHub**: [github.com/TokenMixAi](https://github.com/TokenMixAi)
📦 **PyPI**: [pypi.org/project/tokenmix-tg-bot](https://pypi.org/project/tokenmix-tg-bot/)
📦 **npm**: [npmjs.com/package/tokenmix-tg-bot](https://www.npmjs.com/package/tokenmix-tg-bot)

---

## What is TokenMix?

TokenMix is an **AI API aggregator** — instead of juggling 5 different provider accounts (OpenAI, Anthropic, Google, DeepSeek, Mistral...), you get **one key, one bill, one endpoint**.

Drop-in compatible with the OpenAI Python / Node SDKs — just change the `base_url` to `https://api.tokenmix.ai/v1`.

## Why developers use TokenMix

- 🔑 **One API key for 155+ models** — GPT-5, Claude Opus 4.5, Gemini 3, DeepSeek V3, Qwen, Mistral and more
- 💳 **Unified billing** — pay-as-you-go from $0.10/M tokens
- 🎁 **Free $1 credit** to try every model
- ⚡ **No rate limit juggling** — managed at our side
- 🔌 **OpenAI compatible** — drop-in replacement

## Open-source projects

| Project | Language | Install |
|---------|----------|---------|
| [tg-ai-bot (Python)](https://github.com/TokenMixAi/tg-ai-bot) | Python 3.9+ | `pip install tokenmix-tg-bot` |
| [tg-ai-bot (Node.js)](https://github.com/TokenMixAi/tg-ai-bot/tree/main/nodejs) | Node.js 18+ | `npm install -g tokenmix-tg-bot` |

Both are AI chatbots for Telegram with streaming + vision support — under 200 lines of code each.

## Get started in 60 seconds

1. Sign up at [tokenmix.ai](https://tokenmix.ai) (no credit card required)
2. Get your API key
3. Use the OpenAI SDK with `base_url=https://api.tokenmix.ai/v1`

```python
from openai import OpenAI
client = OpenAI(api_key="tm-...", base_url="https://api.tokenmix.ai/v1")
client.chat.completions.create(model="gpt-5", messages=[...])