pi-openmodel-provider

A pi custom provider that connects pi to OpenModel.ai — a unified AI API gateway.

Disclaimer: This is an unofficial, community-maintained package. I am not affiliated with, endorsed by, or connected to OpenModel in any way. This provider simply forwards requests to the public OpenModel API using your own API key.

Note: This package only provides a model provider. It does not include an API key. You must bring your own OpenModel API key.

▶️ Watch the video tutorial — See the full installation and usage walkthrough.

Install + Quick start

pi install npm:pi-openmodel-provider

Step	What to do
1️⃣	/reload (so OpenModel appears in /login)
2️⃣	/login → "Use a subscription" → OpenModel → "Paste API key manually" → paste your key
3️⃣	/reload (so models load)
4️⃣	Ctrl + L or /model openmodel/deepseek-v4-flash to select your model

Done! You can now use OpenModel in pi.

Usage

After setup, select any OpenModel model:

/model openmodel/deepseek-v4-flash

Press Ctrl + L to open the model selector and browse available models.

Models

Models are fetched live from OpenModel's API at startup, so new models show up without a package release.

Supported Providers

Provider	Models
OpenAI	GPT-5.x family
Anthropic	Claude Opus/Sonnet/Haiku
Google Gemini	Gemini Flash/Pro
DeepSeek	DeepSeek V4 (1M context)
Alibaba Qwen	Qwen3.x family
Xiaomi (MiMo)	Mimo v2.x
Moonshot (Kimi)	Kimi K2.x
MiniMax	MiniMax M2.x/M3
ZAI (GLM)	GLM-4.x/5.x

Model discovery

On startup, the provider fetches models from two public endpoints (no authentication required):

• Model list & protocols: https://api.openmodel.ai/v1/models
• Pricing & capabilities: https://api.openmodel.ai/web/v1/models

Pricing, context window, reasoning support, and vision capabilities are all provided by the API — no hardcoded data.

Pricing

Model pricing is fetched live from OpenModel's public API (/web/v1/models). Each model returns its real per-token rates in microdollars, converted to dollars per million tokens for display.

• Input and output tokens are billed at separate rates
• Cache reads and writes are billed at reduced rates
• A price_multiplier may apply (e.g., 0.95 = 5% discount)
• Free models have zero cost

Features

• 41 models from 9+ providers (dynamically fetched)
• 3 protocols: Messages (Anthropic), Responses (OpenAI), Gemini (Google)
• Model stability metrics via /openmodel-stability
• 1M context window for DeepSeek V4 models
• Thinking levels for reasoning models (DeepSeek, Claude, GPT, Gemini, etc.)
• Friendly error messages with emojis and actionable guidance
• No hardcoding — new models, pricing, and capabilities appear automatically

Error handling

Errors from OpenModel's API are shown with friendly messages:

HTTP Status	What you'll see
401	🔑 Invalid API key. Check your credentials or run /login again.
402	💳 Insufficient balance. Top up at console.openmodel.ai
429	⏳ Rate limited. Try again later.
404	🔍 Resource not found. Check the model name.
5xx	🔧 OpenModel API error. Try again later.

For stability endpoints, errors include context about what went wrong.

Commands

/openmodel                Show provider status
/openmodel-stability      Show health metrics for all models
/openmodel-stability <model>  Show detailed metrics for a specific model

Stability explained

The /openmodel-stability command shows how healthy each model is:

Symbol	Meaning	Condition
✅ Operational	Healthy	≥99.9% success + enough data
🟢 Healthy	Good	≥99% success
🟡 Degraded	Some issues	≥95% success
🔴 Unstable	Problems	<95% success
⚪ No Data	Not enough info	<10 requests (low confidence)

✅ deepseek-v4-flash  100.0%   8541ms   136.4 t/s
   ↑         ↑          ↑        ↑          ↑
   |         |          |        |          └── Tokens per second
   |         |          |        └── Average latency (ms)
   |         |          └── Success rate
   |         └── Model name
   └── Health status

Development

# Clone the repo
git clone https://github.com/IvanGabrielYarupaitanRivera/pi-openmodel-provider
cd pi-openmodel-provider

# Install dependencies
npm install

# Type check
npm run typecheck

# Run all tests
npm test

# Run specific tests
npm run test:models
npm run test:auth
npm run test:pricing
npm run test:stability

Contributing

See CONTRIBUTING.md for development setup, PR expectations, and commit message rules.

Release

See RELEASE.md for prerelease, npm smoke-test, stable publish, git tag, and GitHub follow-up checklist.

License

MIT

---

Maintained by Ivan Gabriel Yarupaitan Rivera