Refresh lockfile and dependencies within existing ranges via npm update. Co-authored-by: Simon Shi <simonsmh@users.noreply.github.com>
pi-provider-qoder
A pi provider extension that connects pi to the Qoder API, exposing Qoder Global and Qoder China models through provider surfaces.
Features
- Two provider entries:
qoder— Global / international Qoder.qoder-cn— Qoder China, always bound to CN endpoints.
- Interactive Login: Global Qoder supports browser device-code flow or Personal Access Token (PAT) login.
- Qoder CN PAT Login: China edition uses a separate PAT login entry (
/login qoder-cn) and CN token exchange endpoints. - WAF Bypass: Built-in WAF obfuscation and body encoding (
Encode=1). - COSY Signing: Full COSY signature header generation (RSA/AES-CBC/MD5).
- Dynamic Model Catalog: Dynamically fetches model limits, effort configurations, and options from the
/algo/api/v2/model/listendpoint. - Reasoning/Thinking Support: Real-time extraction of thinking process from API reasoning or HTML-like
<think>tags.
Quick start
Install the provider:
pi install npm:pi-provider-qoder
Or install it globally with npm:
npm install -g pi-provider-qoder
Then log in from pi.
Global / international edition:
/login qoder
China edition:
/login qoder-cn
Personal Access Token (PAT)
A Qoder PAT (pt-...) cannot authenticate API calls directly — the provider
exchanges it for a short-lived job token (mirroring the official qodercli /
qoderclicn flow) and resolves your account identity automatically.
Global Qoder:
- Run
/login qoderand choose Use API Key (PAT), then paste the token. - Or set
QODER_PERSONAL_ACCESS_TOKEN(orQODER_PAT) before starting pi. QODER_API_KEYis also accepted; when set, pi automatically exchanges it and logs the provider in during startup.
Qoder China:
- Run
/login qoder-cn, then paste the CN PAT. - Or set
QODERCN_PERSONAL_ACCESS_TOKEN(orQODERCN_PAT) before starting pi. QODERCN_API_KEYis also accepted and triggers the same automatic startup login.
The exchanged job token is short-lived; the provider transparently re-exchanges the stored PAT when it expires.
Endpoints
Global:
- PAT exchange:
https://openapi.qoder.sh/api/v1/jobToken/exchange - User info:
https://openapi.qoder.sh/api/v1/userinfo - Usage:
https://openapi.qoder.sh/api/v2/quota/usage - Model / chat gateway:
https://api3.qoder.sh/algo/api/v2/...
China:
- PAT exchange:
https://openapi.qoder.com.cn/api/v1/jobToken/exchange - User info:
https://openapi.qoder.com.cn/api/v1/userinfo - Usage:
https://openapi.qoder.com.cn/api/v2/quota/usage - Model / chat gateway:
https://gateway.qoder.com.cn/algo/api/v2/...
Models
Global qoder
Exposes friendly IDs derived from the catalog display_name (whitespace is
removed), including:
- Tier Models:
Auto,Ultimate,Performance,Efficient,Lite - Frontier Models:
Qwen3.7PlusCantusQwen3.8-MaxQwen3.7-MaxDeepSeek-V4-ProDeepSeek-V4-FlashGLM-5.2Kimi-K2.7-CodeKimi-K3MiniMax-M3
Only these friendly IDs are public. Service keys such as lite, qfmodel, and
qmodel cannot be selected with --model; the provider maps the chosen
friendly ID to its internal service key only when sending a request.
Global models default to a 1M context window, matching the Qoder API (verified
against lite with prompts up to 1,000K tokens). kmodel stays at the 256K its
catalog entry advertises. Once you log in, the live /model/list catalog
overrides these fallbacks with the largest context option each model exposes.
China qoder-cn
The China provider exposes friendly model IDs and maps them back to Qoder CN's internal keys at request time:
| Friendly ID | Qoder CN key | Context | Images | Reasoning |
|---|---|---|---|---|
Auto |
auto |
200K | ✅ | ✅ |
Qwen3.7-Max |
qmodel_latest |
1M | ✅ | ✅ |
Qwen3.7-Plus |
qmodel |
1M | ❌ | ✅ |
Qwen3.6-Flash |
q36fmodel |
1M | ❌ | ✅ |
DeepSeek-V4-Pro |
dmodel |
1M | ❌ | ✅ |
DeepSeek-V4-Flash |
dfmodel |
1M | ❌ | ❌ |
GLM-5.2 |
gm51model |
200K | ✅ | ✅ |
Kimi-K2.7-Code |
kmodel |
256K | ✅ | ✅ |
MiniMax-M2.7 |
mmodel |
200K | ❌ | ❌ |
Usage
Once logged in, select any Qoder model in pi:
/model Qwen3.7-Plus
Or start directly:
pi --provider qoder-cn --model Qwen3.7-Plus
Global example:
pi --provider qoder --model Lite
Architecture
src/
├── index.ts # Register the two providers
├── region.ts # Fixed global/CN configuration and URL helpers
├── cosy.ts # COSY signing, machine ID, and gateway headers
├── catalog.ts # Friendly model IDs, live catalog cache, static seeds
├── auth/
│ ├── pat.ts # PAT → job-token exchange and identity
│ ├── login.ts # Browser/PAT login sequence
│ ├── oauth.ts # OAuth callback and credential orchestration
│ └── usage.ts # Quota reporting
└── protocol/
├── stream.ts # Shared streaming request/response handler
├── transform.ts # Message and tool conversion
├── encoding.ts # WAF bypass body encoder
└── thinking.ts # Fallback <think> tag parser
License
MIT