modelmix 5.1.6 → 5.1.9

package/README.md

@@ -177,9 +177,11 @@ ModelMix provides convenient shorthand methods for quickly accessing different A
 | `qwen37plus()` | Fireworks | models/qwen3p7-plus | [\$0.40][10] | [\$1.60][10] |
 | `qwen38max()` | Fireworks | qwen3p8-2p4t-a95b | [\$2.00][10] | [\$6.00][10] |
 | `qwen3827b()` | OpenRouter | qwen/qwen3.8-27b | [\$0.45][15] | [\$3.20][15] |
+| `qwen38flash()` | OpenRouter | qwen/qwen3.8-flash | [\$0.16][19] | [\$0.47][19] |
 | `deepseekV4Flash()` | Fireworks | models/deepseek-v4-flash | [\$0.14][10] | [\$0.28][10] |
 | `deepseekV4Pro()` | Fireworks | models/deepseek-v4-pro-0813 | [\$1.32][12] | [\$3.96][12] |
 | `GLM53()` | OpenRouter | z-ai/glm-5.3 | [\$1.40][16] | [\$4.40][16] |
+| `GLM53Flash()` | OpenRouter | z-ai/glm-5.3-flash | [\$0.075][20] | [\$0.25][20] |
 | `GLM52()` | Together | zai-org/GLM-5.2 | [\$1.40][7] | [\$4.40][7] |
 | `minimaxM3()` | MiniMax | MiniMax-M3 | [\$0.30][9] | [\$1.20][9] |
 | `minimaxM27()` | MiniMax | MiniMax-M2.7 | [\$0.30][9] | [\$1.20][9] |
@@ -217,6 +219,8 @@ The multi-provider shortcuts also expose the current catalog alternatives: `gptO
 [16]: https://openrouter.ai/z-ai/glm-5.3 "GLM 5.3 on OpenRouter"
 [17]: https://fireworks.ai/models/fireworks/muse-glimmer-30b "Muse Glimmer 30B on Fireworks"
 [18]: https://openrouter.ai/qwen/qwen3.6-plus "Qwen 3.6 Plus on OpenRouter"
+[19]: https://openrouter.ai/qwen/qwen3.8-flash "Qwen3.8 Flash on OpenRouter"
+[20]: https://openrouter.ai/z-ai/glm-5.3-flash "GLM 5.3 Flash on OpenRouter"
 
 Each method accepts optional `options`, `config`, and (for multi-provider methods) `mix` parameters to customize behavior.  
 
@@ -257,8 +261,8 @@ ModelMix.new().effort(-1).minimaxM3().addText('...').message();
 
 - **Gemini:** Gemini 3+ uses bands 0–24 / 25–49 / 50–74 / 75–100. Gemini 3.7 Flash clamps these bands to `low` / `low` / `medium` / `high`; `-1` leaves its native `medium` default unchanged. Gemini 2.5 maps 0–100 to `thinkingBudget`.
 - **GPT-5.6:** `100` maps to `max`; 80–99 remains `xhigh`.
-- **Qwen 3.8 27B:** 0–39 / 40–79 / 80–100 map to `low` / `medium` / `xhigh`; `-1` leaves the native `xhigh` default unchanged.
-- **GLM 5.3:** reasoning is mandatory; 0–39 / 40–79 / 80–100 map to `low` / `high` / `max`; `-1` leaves the native `max` default unchanged.
+- **Qwen 3.8 27B and Flash:** 0–39 / 40–79 / 80–100 map to `low` / `medium` / `xhigh`; `-1` leaves the native `xhigh` default unchanged. Qwen 3.8 Flash is the managed production version based on the open-weight Flash-Next architecture.
+- **GLM 5.3 and GLM 5.3 Flash:** reasoning is mandatory; 0–39 / 40–79 / 80–100 map to `low` / `high` / `max`; `-1` leaves the native `max` default unchanged.
 - **DeepSeek:** `↑` means thinking is enabled; `off` means it is disabled.
 - **MiniMax:** `off` maps to `thinking.disabled`; `adaptive` maps to `thinking.type=adaptive`.
 - **Anthropic:** Claude 5, Fable, Opus 4.6+, and Sonnet 4.6+ use adaptive thinking with `output_config.effort`. Sonnet 4.5 and Haiku 4.5 use `thinking.type=enabled` with `budget_tokens`.

package/demo/short.js

@@ -16,10 +16,12 @@ const mmix = await ModelMix.new(setup)
     .grok46() // (fallback 4) Grok grok-4.6
     .qwen35397b() // (fallback 5) OpenRouter qwen/qwen3.5-397b-a17b
     .qwen3827b() // (fallback 6) OpenRouter qwen/qwen3.8-27b
-    .GLM53() // (fallback 7) OpenRouter z-ai/glm-5.3
-    .museGlimmer30b({ mix: { fireworks: false, openrouter: true } }) // (fallback 8) OpenRouter meta/muse-glimmer-30b
-    .hermes470b() // (fallback 9) OpenRouter nousresearch/hermes-4-70b
-    .hermes4405b() // (fallback 10) OpenRouter nousresearch/hermes-4-405b
+    .qwen38flash() // (fallback 7) OpenRouter qwen/qwen3.8-flash
+    .GLM53() // (fallback 8) OpenRouter z-ai/glm-5.3
+    .GLM53Flash() // (fallback 9) OpenRouter z-ai/glm-5.3-flash
+    .museGlimmer30b({ mix: { fireworks: false, openrouter: true } }) // (fallback 10) OpenRouter meta/muse-glimmer-30b
+    .hermes470b() // (fallback 11) OpenRouter nousresearch/hermes-4-70b
+    .hermes4405b() // (fallback 12) OpenRouter nousresearch/hermes-4-405b
     .addText("What's your name?");
 
 console.log(await mmix.message());

package/effort.js

@@ -50,7 +50,9 @@ const OPENAI_MODEL_LEVELS = {
     'meta-models/Muse-Glimmer-30B': ['low', 'medium', 'high', 'xhigh'],
     'accounts/fireworks/models/qwen3p8-2p4t-a95b': ['none', 'low', 'medium', 'high'],
     'qwen/qwen3.8-27b': ['low', 'medium', 'xhigh'],
+    'qwen/qwen3.8-flash': ['low', 'medium', 'xhigh'],
     'z-ai/glm-5.3': ['low', 'high', 'max'],
+    'z-ai/glm-5.3-flash': ['low', 'high', 'max'],
     'grok-4.6': ['low', 'medium', 'high', 'xhigh'],
     'gpt-5': ['minimal', 'low', 'medium', 'high'],
     'gpt-5-mini': ['minimal', 'low', 'medium', 'high'],
@@ -396,7 +398,7 @@ function mapEffort(providerFamily, effort, modelKey) {
             return null;
         }
         const supported = supportedOpenAILevels(modelKey);
-        const desired = modelKey === 'z-ai/glm-5.3'
+        const desired = modelKey === 'z-ai/glm-5.3' || modelKey === 'z-ai/glm-5.3-flash'
             ? levelFromBands(normalized, GLM53_BANDS)
             : normalized === 100 && supported.includes('max')
                 ? 'max'

package/index.d.ts

@@ -502,6 +502,7 @@ export declare class ModelMix {
   qwen37plus(args?: ModelAttachArgs): this;
   qwen38max(args?: ModelAttachArgs): this;
   qwen3827b(args?: ModelAttachArgs): this;
+  qwen38flash(args?: ModelAttachArgs): this;
   hermes470b(args?: ModelAttachArgs): this;
   hermes4405b(args?: ModelAttachArgs): this;
   hermes3(args?: ModelAttachArgs): this;
@@ -518,6 +519,7 @@ export declare class ModelMix {
   deepseekV4Flash(args?: ModelAttachArgs): this;
   GLM52(args?: ModelAttachArgs): this;
   GLM53(args?: ModelAttachArgs): this;
+  GLM53Flash(args?: ModelAttachArgs): this;
 
   addText(text: string, options?: RoleOptions): this;
   addTextFromFile(filePath: string, options?: RoleOptions): this;

package/index.js

@@ -616,6 +616,10 @@ class ModelMix {
         return this.attach('qwen/qwen3.8-27b', new MixOpenRouter({ options, config }));
     }
 
+    qwen38flash({ options = {}, config = {} } = {}) {
+        return this.attach('qwen/qwen3.8-flash', new MixOpenRouter({ options, config }));
+    }
+
     hermes470b({ options = {}, config = {} } = {}) {
         return this.attach('nousresearch/hermes-4-70b', new MixOpenRouter({ options, config }));
     }
@@ -732,6 +736,10 @@ class ModelMix {
         return this.attach('z-ai/glm-5.3', new MixOpenRouter({ options, config }));
     }
 
+    GLM53Flash({ options = {}, config = {} } = {}) {
+        return this.attach('z-ai/glm-5.3-flash', new MixOpenRouter({ options, config }));
+    }
+
     addText(text, { role = "user", cache } = {}) {
         return this._addText(text, {
             role,

package/lib/model-chain.js

@@ -11,11 +11,11 @@ const CHAIN_MODEL_SHORTCUTS = new Set([
     'gemini35flashLite', 'gemini31flashLite', 'sonarPro', 'sonar',
     'grok46', 'grok45', 'grok43', 'grok420multiAgent', 'grok420',
     'museGlimmer30b',
-    'qwen35397b', 'qwen36plus', 'qwen37plus', 'qwen38max', 'qwen3827b',
+    'qwen35397b', 'qwen36plus', 'qwen37plus', 'qwen38max', 'qwen3827b', 'qwen38flash',
     'hermes470b', 'hermes4405b', 'hermes3',
     'kimiK26', 'kimiK27Code', 'kimiK3', 'kimiK25',
     'minimaxM27', 'minimaxM3', 'mimo25', 'mimo25pro',
-    'deepseekV4Pro', 'deepseekV4Flash', 'GLM52', 'GLM53'
+    'deepseekV4Pro', 'deepseekV4Flash', 'GLM52', 'GLM53', 'GLM53Flash'
 ]);
 
 function parseChainModels(modelSpecs) {

package/lib/providers/anthropic.js

@@ -48,14 +48,14 @@ function createAnthropicProviders({ ModelMix, MixCustom, log }) {
         }
     
         getDefaultConfig(customConfig) {
-    
-            if (!process.env.ANTHROPIC_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.ANTHROPIC_API_KEY;
+            if (!apiKey) {
                 throw new Error('Anthropic API key not found. Please provide it in config or set ANTHROPIC_API_KEY environment variable.');
             }
     
             return super.getDefaultConfig({
                 url: 'https://api.anthropic.com/v1/messages',
-                apiKey: process.env.ANTHROPIC_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }

package/lib/providers/base.js

@@ -274,14 +274,14 @@ function createBaseProviders({ ModelMix }) {
         }
     
         getDefaultConfig(customConfig) {
-    
-            if (!process.env.OPENAI_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.OPENAI_API_KEY;
+            if (!apiKey) {
                 throw new Error('OpenAI API key not found. Please provide it in config or set OPENAI_API_KEY environment variable.');
             }
     
             return super.getDefaultConfig({
                 url: 'https://api.openai.com/v1/chat/completions',
-                apiKey: process.env.OPENAI_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }

package/lib/providers/google.js

@@ -4,9 +4,10 @@ const { configForDebug } = require('../provider-debug');
 function createGoogleProviders({ ModelMix, MixCustom }) {
     class MixGoogle extends MixCustom {
         getDefaultConfig(customConfig) {
+            const apiKey = customConfig.apiKey || process.env.GEMINI_API_KEY;
             return super.getDefaultConfig({
                 url: 'https://generativelanguage.googleapis.com/v1beta/models',
-                apiKey: process.env.GEMINI_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }

package/lib/providers/openai-compatible.js

@@ -6,14 +6,14 @@ const {
 function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     class MixMiniMax extends MixOpenAI {
         getDefaultConfig(customConfig) {
-    
-            if (!process.env.MINIMAX_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.MINIMAX_API_KEY;
+            if (!apiKey) {
                 throw new Error('MiniMax API key not found. Please provide it in config or set MINIMAX_API_KEY environment variable.');
             }
     
             return MixCustom.prototype.getDefaultConfig.call(this, {
                 url: 'https://api.minimax.io/v1/chat/completions',
-                apiKey: process.env.MINIMAX_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }
@@ -29,13 +29,14 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixMiMo extends MixOpenAI {
         getDefaultConfig(customConfig) {
-            if (!process.env.MIMO_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.MIMO_API_KEY;
+            if (!apiKey) {
                 throw new Error('MiMo API key not found. Please provide it in config or set MIMO_API_KEY environment variable.');
             }
     
             return MixCustom.prototype.getDefaultConfig.call(this, {
                 url: 'https://api.xiaomimimo.com/v1/chat/completions',
-                apiKey: process.env.MIMO_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }
@@ -52,14 +53,14 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixPerplexity extends MixCustom {
         getDefaultConfig(customConfig) {
-    
-            if (!process.env.PPLX_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.PPLX_API_KEY;
+            if (!apiKey) {
                 throw new Error('Perplexity API key not found. Please provide it in config or set PPLX_API_KEY environment variable.');
             }
     
             return super.getDefaultConfig({
                 url: 'https://api.perplexity.ai/chat/completions',
-                apiKey: process.env.PPLX_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }
@@ -132,14 +133,14 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixGrok extends MixOpenAI {
         getDefaultConfig(customConfig) {
-    
-            if (!process.env.XAI_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.XAI_API_KEY;
+            if (!apiKey) {
                 throw new Error('Grok API key not found. Please provide it in config or set XAI_API_KEY environment variable.');
             }
     
             return super.getDefaultConfig({
                 url: 'https://api.x.ai/v1/chat/completions',
-                apiKey: process.env.XAI_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }
@@ -154,14 +155,14 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixLambda extends MixCustom {
         getDefaultConfig(customConfig) {
-    
-            if (!process.env.LAMBDA_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.LAMBDA_API_KEY;
+            if (!apiKey) {
                 throw new Error('Lambda API key not found. Please provide it in config or set LAMBDA_API_KEY environment variable.');
             }
     
             return super.getDefaultConfig({
                 url: 'https://api.lambda.ai/v1/chat/completions',
-                apiKey: process.env.LAMBDA_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }
@@ -234,14 +235,14 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixGroq extends MixCustom {
         getDefaultConfig(customConfig) {
-    
-            if (!process.env.GROQ_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.GROQ_API_KEY;
+            if (!apiKey) {
                 throw new Error('Groq API key not found. Please provide it in config or set GROQ_API_KEY environment variable.');
             }
     
             return super.getDefaultConfig({
                 url: 'https://api.groq.com/openai/v1/chat/completions',
-                apiKey: process.env.GROQ_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }
@@ -249,14 +250,14 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixTogether extends MixCustom {
         getDefaultConfig(customConfig) {
-    
-            if (!process.env.TOGETHER_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.TOGETHER_API_KEY;
+            if (!apiKey) {
                 throw new Error('Together API key not found. Please provide it in config or set TOGETHER_API_KEY environment variable.');
             }
     
             return super.getDefaultConfig({
                 url: 'https://api.together.xyz/v1/chat/completions',
-                apiKey: process.env.TOGETHER_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }
@@ -271,14 +272,14 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixCerebras extends MixCustom {
         getDefaultConfig(customConfig) {
-    
-            if (!process.env.CEREBRAS_API_KEY) {
-                throw new Error('Together API key not found. Please provide it in config or set CEREBRAS_API_KEY environment variable.');
+            const apiKey = customConfig.apiKey || process.env.CEREBRAS_API_KEY;
+            if (!apiKey) {
+                throw new Error('Cerebras API key not found. Please provide it in config or set CEREBRAS_API_KEY environment variable.');
             }
     
             return super.getDefaultConfig({
                 url: 'https://api.cerebras.ai/v1/chat/completions',
-                apiKey: process.env.CEREBRAS_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }
@@ -291,14 +292,14 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixFireworks extends MixCustom {
         getDefaultConfig(customConfig) {
-    
-            if (!process.env.FIREWORKS_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.FIREWORKS_API_KEY;
+            if (!apiKey) {
                 throw new Error('Fireworks API key not found. Please provide it in config or set FIREWORKS_API_KEY environment variable.');
             }
     
             return super.getDefaultConfig({
                 url: 'https://api.fireworks.ai/inference/v1/chat/completions',
-                apiKey: process.env.FIREWORKS_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }
@@ -306,14 +307,14 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixNVIDIA extends MixCustom {
         getDefaultConfig(customConfig) {
-    
-            if (!process.env.NVIDIA_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.NVIDIA_API_KEY;
+            if (!apiKey) {
                 throw new Error('NVIDIA API key not found. Please provide it in config or set NVIDIA_API_KEY environment variable.');
             }
     
             return super.getDefaultConfig({
                 url: 'https://integrate.api.nvidia.com/v1/chat/completions',
-                apiKey: process.env.NVIDIA_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }

package/lib/providers/openai.js

@@ -556,14 +556,14 @@ function createOpenAIProviders({
     
     class MixOpenRouter extends MixOpenAI {
         getDefaultConfig(customConfig) {
-    
-            if (!process.env.OPENROUTER_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.OPENROUTER_API_KEY;
+            if (!apiKey) {
                 throw new Error('OpenRouter API key not found. Please provide it in config or set OPENROUTER_API_KEY environment variable.');
             }
     
             return MixCustom.prototype.getDefaultConfig.call(this, {
                 url: 'https://openrouter.ai/api/v1/chat/completions',
-                apiKey: process.env.OPENROUTER_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }
@@ -571,13 +571,14 @@ function createOpenAIProviders({
     
     class MixKimi extends MixOpenAI {
         getDefaultConfig(customConfig) {
-            if (!process.env.MOONSHOT_API_KEY) {
+            const apiKey = customConfig.apiKey || process.env.MOONSHOT_API_KEY;
+            if (!apiKey) {
                 throw new Error('Moonshot API key not found. Please provide it in config or set MOONSHOT_API_KEY environment variable.');
             }
     
             return MixCustom.prototype.getDefaultConfig.call(this, {
                 url: 'https://api.moonshot.ai/v1/chat/completions',
-                apiKey: process.env.MOONSHOT_API_KEY,
+                apiKey,
                 ...customConfig
             });
         }

package/lib/token-usage.js

@@ -91,6 +91,7 @@ const MODEL_PRICING = {
     'accounts/fireworks/models/glm-5p2': { input: 1.40, cachedInput: 0.14, output: 4.40 },
     'z-ai/glm-5.2': { input: 0.966, cachedInput: 0.1932, output: 3.036 },
     'z-ai/glm-5.3': { input: 1.40, cachedInput: 0.26, output: 4.40 },
+    'z-ai/glm-5.3-flash': { input: 0.075, cachedInput: 0.015, output: 0.25 },
     'accounts/fireworks/models/kimi-k2p5': { input: 0.50, output: 2.80 },
     'qwen/qwen3.5-397b-a17b': { input: 0.385, output: 2.45 },
     'accounts/fireworks/models/qwen3p6-plus': { input: 0.50, output: 3.00 },
@@ -113,6 +114,7 @@ const MODEL_PRICING = {
     'accounts/fireworks/models/qwen3p8-2p4t-a95b': { input: 2.00, cachedInput: 0.25, output: 6.00 },
     'qwen/qwen3.8-max': { input: 2.00, output: 6.00 },
     'qwen/qwen3.8-27b': { input: 0.45, cachedInput: 0.05, output: 3.20 },
+    'qwen/qwen3.8-flash': { input: 0.16, cachedInput: 0.016, cacheWrite: 0.20, output: 0.47 },
     // MiniMax
     'MiniMax-M2.5': { input: 0.30, output: 1.20 },
     'MiniMax-M2.7': { input: 0.30, output: 1.20 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modelmix",
-  "version": "5.1.6",
+  "version": "5.1.9",
   "description": "🧬 Reliable interface with automatic fallback for AI LLMs.",
   "main": "index.js",
   "types": "index.d.ts",

package/skills/modelmix/SKILL.md

@@ -143,7 +143,7 @@ ModelMix.new({ config: { effort: 80 } })
 | DeepSeek V4 | off | `low`↑ | `high`↑ | `high`↑ | `max`↑ | — |
 | MiniMax M3 | off | adaptive | adaptive | adaptive | adaptive | adaptive |
 
-\* GPT-5.6 maps `100` to `max`; 80–99 remains `xhigh`. Qwen 3.8 27B maps 0–39 / 40–79 / 80–100 to `low` / `medium` / `xhigh`. GLM 5.3 requires reasoning and maps those bands to `low` / `high` / `max`. Gemini bands: 0–24 / 25–49 / 50–74 / 75–100. Gemini 3.7 Flash supports only `low` / `medium` / `high`, so the first two bands clamp to `low`; `-1` keeps its native `medium` default. DeepSeek `↑` = thinking on; `off` = thinking disabled. MiniMax `off`/`adaptive` = `thinking.disabled` / `thinking.type=adaptive`. Gemini 2.5 maps 0–100 to `thinkingBudget`. Anthropic: adaptive + `output_config.effort` on Claude 5 / Fable / Opus 4.6+ / Sonnet 4.6+; Sonnet 4.5 / Haiku 4.5 use `thinking.type=enabled` + `budget_tokens`. Grok 4.6 maps 0–39 / 40–59 / 60–79 / 80–100 to `low` / `medium` / `high` / `xhigh`; without effort it uses native `high`. `-1` = adaptive/dynamic when available, else no-op. Levels clamp per model. Former `*think()` methods are removed — use `.effort(n).<model>()`. Kimi: `kimiK25()` / `kimiK26()`. Grok 4.20: `.grok420()` non-reasoning; `.effort(20+|-1).grok420()` selects reasoning.
+\* GPT-5.6 maps `100` to `max`; 80–99 remains `xhigh`. Qwen 3.8 27B and Flash map 0–39 / 40–79 / 80–100 to `low` / `medium` / `xhigh`; Qwen 3.8 Flash is the managed production version based on Flash-Next. GLM 5.3 and GLM 5.3 Flash require reasoning and map those bands to `low` / `high` / `max`. Gemini bands: 0–24 / 25–49 / 50–74 / 75–100. Gemini 3.7 Flash supports only `low` / `medium` / `high`, so the first two bands clamp to `low`; `-1` keeps its native `medium` default. DeepSeek `↑` = thinking on; `off` = thinking disabled. MiniMax `off`/`adaptive` = `thinking.disabled` / `thinking.type=adaptive`. Gemini 2.5 maps 0–100 to `thinkingBudget`. Anthropic: adaptive + `output_config.effort` on Claude 5 / Fable / Opus 4.6+ / Sonnet 4.6+; Sonnet 4.5 / Haiku 4.5 use `thinking.type=enabled` + `budget_tokens`. Grok 4.6 maps 0–39 / 40–59 / 60–79 / 80–100 to `low` / `medium` / `high` / `xhigh`; without effort it uses native `high`. `-1` = adaptive/dynamic when available, else no-op. Levels clamp per model. Former `*think()` methods are removed — use `.effort(n).<model>()`. Kimi: `kimiK25()` / `kimiK26()`. Grok 4.20: `.grok420()` non-reasoning; `.effort(20+|-1).grok420()` selects reasoning.
 
 ## Available Model Shorthands
 
@@ -186,7 +186,7 @@ Use `.effort(n)` (or `config.effort`) to enable Anthropic thinking — e.g. `.ef
 `GLM46()`
 
 ### OpenRouter
-`museGlimmer30b()` `gptOss()` `qwen35397b()` `qwen36plus()` `qwen37plus()` `qwen3827b()` `hermes470b()` `hermes4405b()` `qwen38max()` `kimiK27Code()` `kimiK3()` `minimaxM27()` `minimaxM3()` `GLM45()` `GLM52()` `GLM53()`
+`museGlimmer30b()` `gptOss()` `qwen35397b()` `qwen36plus()` `qwen37plus()` `qwen3827b()` `qwen38flash()` `hermes470b()` `hermes4405b()` `qwen38max()` `kimiK27Code()` `kimiK3()` `minimaxM27()` `minimaxM3()` `GLM45()` `GLM52()` `GLM53()` `GLM53Flash()`
 
 ### Multi-provider (auto-fallback across free/paid tiers)
 `hermes3()` `kimiK25()`

package/test/effort.test.js

@@ -140,6 +140,14 @@ describe('Unified effort scale', () => {
             expect(mapEffort('openai', -1, key)).to.equal(null);
         });
 
+        it('maps Qwen 3.8 Flash to its supported reasoning levels', () => {
+            const key = 'qwen/qwen3.8-flash';
+            expect(mapEffort('openai', 0, key)).to.deep.equal({ reasoning_effort: 'low' });
+            expect(mapEffort('openai', 50, key)).to.deep.equal({ reasoning_effort: 'medium' });
+            expect(mapEffort('openai', 100, key)).to.deep.equal({ reasoning_effort: 'xhigh' });
+            expect(mapEffort('openai', -1, key)).to.equal(null);
+        });
+
         it('maps GLM 5.3 to mandatory low, high, and max reasoning', () => {
             const key = 'z-ai/glm-5.3';
             expect(mapEffort('openai', 39, key)).to.deep.equal({ reasoning_effort: 'low' });
@@ -149,6 +157,15 @@ describe('Unified effort scale', () => {
             expect(mapEffort('openai', -1, key)).to.equal(null);
         });
 
+        it('maps GLM 5.3 Flash to mandatory low, high, and max reasoning', () => {
+            const key = 'z-ai/glm-5.3-flash';
+            expect(mapEffort('openai', 39, key)).to.deep.equal({ reasoning_effort: 'low' });
+            expect(mapEffort('openai', 40, key)).to.deep.equal({ reasoning_effort: 'high' });
+            expect(mapEffort('openai', 79, key)).to.deep.equal({ reasoning_effort: 'high' });
+            expect(mapEffort('openai', 80, key)).to.deep.equal({ reasoning_effort: 'max' });
+            expect(mapEffort('openai', -1, key)).to.equal(null);
+        });
+
         it('maps Anthropic adaptive models to thinking + output_config.effort', () => {
             expect(mapEffort('anthropic', 10, 'claude-opus-5')).to.deep.equal({
                 thinking: { type: 'adaptive', display: 'summarized' },

package/test/glm.test.js

@@ -53,4 +53,24 @@ describe('GLM Model Registration Tests', () => {
         expect(model.models).to.have.length(1);
         expect(model.models[0].key).to.equal('z-ai/glm-5.3');
     });
+
+    it('should register GLM 5.3 Flash through OpenRouter', () => {
+        const model = ModelMix.new().GLM53Flash();
+
+        expect(model.models).to.have.length(1);
+        expect(model.models[0].key).to.equal('z-ai/glm-5.3-flash');
+        expect(model.models[0].provider).to.be.instanceOf(MixOpenRouter);
+        expect(ModelMix.calculateCost('z-ai/glm-5.3-flash', {
+            input: 1_000_000,
+            cached: 500_000,
+            output: 1_000_000
+        })).to.equal(0.295);
+    });
+
+    it('should support GLM 5.3 Flash in chain()', () => {
+        const model = ModelMix.new().chain('GLM53Flash');
+
+        expect(model.models).to.have.length(1);
+        expect(model.models[0].key).to.equal('z-ai/glm-5.3-flash');
+    });
 });

package/test/public-api.test.js

@@ -48,6 +48,48 @@ describe('public module boundary', () => {
         expect(model.models[0].provider.constructor).to.equal(api.MixOpenRouter);
     });
 
+    const explicitApiKeyCases = [
+        ['OpenAI', config => new api.MixOpenAIResponses({ config })],
+        ['OpenAI moderation', config => new api.MixOpenAIModeration({ config })],
+        ['Anthropic', config => new api.MixAnthropic({ config })],
+        ['Gemini', config => new api.MixGoogle({ config })],
+        ['MiniMax', config => new api.MixMiniMax({ config })],
+        ['MiMo', config => new api.MixMiMo({ config })],
+        ['Perplexity', config => new api.MixPerplexity({ config })],
+        ['Grok', config => new api.MixGrok({ config })],
+        ['Lambda', config => api.ModelMix.new({ mix: { openrouter: false, lambda: true } })
+            .hermes3({ config }).models[0].provider],
+        ['Groq', config => new api.MixGroq({ config })],
+        ['Together', config => new api.MixTogether({ config })],
+        ['Cerebras', config => new api.MixCerebras({ config })],
+        ['Fireworks', config => new api.MixFireworks({ config })],
+        ['NVIDIA', config => new api.MixNVIDIA({ config })],
+        ['OpenRouter', config => new api.MixOpenRouter({ config })],
+        ['Moonshot', config => new api.MixKimi({ config })]
+    ];
+
+    for (const [providerName, createProvider] of explicitApiKeyCases) {
+        it(`uses an explicit API key for ${providerName} without reading environment credentials`, () => {
+            const originalEnv = process.env;
+            process.env = new Proxy(originalEnv, {
+                get(target, property, receiver) {
+                    if (typeof property === 'string' && property.endsWith('_API_KEY')) {
+                        throw new Error(`${property} should not be read`);
+                    }
+                    return Reflect.get(target, property, receiver);
+                }
+            });
+
+            try {
+                const provider = createProvider({ apiKey: 'explicit-key' });
+
+                expect(provider.config.apiKey).to.equal('explicit-key');
+            } finally {
+                process.env = originalEnv;
+            }
+        });
+    }
+
     it('keeps the mutable pricing catalog private', () => {
         expect(require('../lib/token-usage')).to.not.have.property('MODEL_PRICING');
     });

package/test/qwen.test.js

@@ -110,6 +110,27 @@ describe('Qwen Model Registration Tests', () => {
         expect(model.models[0].key).to.equal('qwen/qwen3.8-27b');
     });
 
+    it('should register Qwen 3.8 Flash through OpenRouter', () => {
+        const model = ModelMix.new().qwen38flash();
+
+        expect(model.models).to.have.length(1);
+        expect(model.models[0].key).to.equal('qwen/qwen3.8-flash');
+        expect(model.models[0].provider).to.be.instanceOf(MixOpenRouter);
+        expect(ModelMix.calculateCost('qwen/qwen3.8-flash', {
+            input: 1_000_000,
+            cached: 250_000,
+            cacheWrite: 100_000,
+            output: 1_000_000
+        })).to.equal(0.598);
+    });
+
+    it('should support Qwen 3.8 Flash in chain()', () => {
+        const model = ModelMix.new().chain('qwen38flash');
+
+        expect(model.models).to.have.length(1);
+        expect(model.models[0].key).to.equal('qwen/qwen3.8-flash');
+    });
+
     it('should register Qwen 3.5 397B A17B through OpenRouter', () => {
         const model = ModelMix.new().qwen35397b();