modelmix 4.5.12 → 4.5.16

package/MODELS.md

@@ -352,4 +352,4 @@ All providers inherit from `MixCustom` base class which provides common function
   - Uses OpenAI-compatible API interface
   - Requires `MINIMAX_API_KEY` environment variable
   - Inherits all OpenAI functionality including tool calling
-  - Available models: `MiniMax-M2` 
+  - Available models: `MiniMax-M2.5`, `MiniMax-M2.7`

package/README.md

@@ -33,6 +33,7 @@ ANTHROPIC_API_KEY="sk-ant-..."
 OPENAI_API_KEY="sk-proj-..."
 OPENROUTER_API_KEY="sk-or-..."
 MINIMAX_API_KEY="your-minimax-key..."
+NVIDIA_API_KEY="nvapi-..."
 ...
 GEMINI_API_KEY="AIza..."
 ```
@@ -68,7 +69,7 @@ const model = await ModelMix.new(setup)
     .sonnet46() // (main model) Anthropic claude-sonnet-4-5-20250929
     .gpt5mini() // (fallback 2) OpenAI gpt-5-mini
     .gemini3flash({ config: { temperature: 0 } }) // (fallback 3) Google gemini-3-flash
-    .grok3mini() // (fallback 4) Grok grok-3-mini
+    .grok43() // (fallback 4) Grok grok-4.3
     .addText("What's your name?");
 
 console.log(await model.message());
@@ -150,23 +151,22 @@ Here's a comprehensive list of available methods:
 | `opus47[think]()`   | Anthropic  | claude-opus-4-7              | [\$5.00 / \$25.00][2]      |
 | `opus46[think]()`   | Anthropic  | claude-opus-4-6              | [\$5.00 / \$25.00][2]      |
 | `sonnet46[think]()` | Anthropic  | claude-sonnet-4-6            | [\$3.00 / \$15.00][2]      |
-| `sonnet45[think]()` | Anthropic  | claude-sonnet-4-5-20250929   | [\$3.00 / \$15.00][2]      |
 | `haiku45[think]()`  | Anthropic  | claude-haiku-4-5-20251001    | [\$1.00 / \$5.00][2]       |
 | `gemini31pro()`     | Google     | gemini-3.1-pro-preview       | [\$2.00 / \$12.00][3]      |
-| `gemini3pro()`      | Google     | gemini-3-pro-preview         | [\$2.00 / \$12.00][3]      |
-| `gemini3flash()`     | Google     | gemini-3-flash-preview        | [\$0.50 / \$3.00][3]       |
 | `gemini31flashLite()`| Google     | gemini-3.1-flash-lite-preview | [\$0.25 / \$1.50][3]       |
-| `grok4()`           | Grok       | grok-4-0709                  | [\$3.00 / \$15.00][6]      |
+| `grok43()`          | Grok       | grok-4.3                     | [\$1.25 / \$2.50][6]       |
+| `grok420multiAgent()`| Grok      | grok-4.20-multi-agent-0309   | [\$1.25 / \$2.50][6]       |
+| `grok420[think]()`  | Grok       | grok-4.20-0309               | [\$1.25 / \$2.50][6]       |
 | `grok41[think]()`   | Grok       | grok-4-1-fast                | [\$0.20 / \$0.50][6]       |
+| `qwen36plus()`      | Fireworks/Together | qwen3p6-plus / Qwen3.6-Plus | [\$0.50 / \$3.00][10] |
 | `deepseekV4Pro()`   | Fireworks  | models/deepseek-v4-pro       | [\$1.74 / \$3.48][10]      |
 | `GLM51()`           | Fireworks  | models/glm-5p1               | [\$1.05 / \$3.50][10]      |
 | `minimaxM27()`      | MiniMax    | MiniMax-M2.7                 | [\$0.30 / \$1.20][9]       |
 | `sonar()`           | Perplexity | sonar                        | [\$1.00 / \$1.00][4]       |
 | `sonarPro()`        | Perplexity | sonar-pro                    | [\$3.00 / \$15.00][4]      |
 | `hermes3()`         | Lambda     | Hermes-3-Llama-3.1-405B-FP8  | [\$0.80 / \$0.80][8]       |
-| `qwen3()`           | Together   | Qwen3-235B-A22B-fp8-tput     | [\$0.20 / \$0.60][7]       |
 | `kimiK25think()`    | Together   | Kimi-K2.5                    | [\$0.50 / \$2.80][7]       |
-| `kimiK26think()`    | Fireworks  | models/kimi-k2p6             | [\$0.95 / \$4.00][10]       |
+| `kimiK26think()`    | Fireworks  | models/kimi-k2p6             | [\$0.95 / \$4.00][10]      |
 
 [1]: https://platform.openai.com/docs/pricing "Pricing | OpenAI"
 [2]: https://docs.anthropic.com/en/docs/about-claude/pricing "Pricing - Anthropic"
@@ -179,7 +179,9 @@ Here's a comprehensive list of available methods:
 [9]: https://platform.minimax.io/docs/api-reference/anthropic-api-compatible-cache#supported-models-and-pricing "MiniMax Pricing"
 [10]: https://fireworks.ai/pricing#serverless-pricing "Fireworks Pricing"
 
-Each method accepts optional `options` and `config` parameters to customize the model's behavior. For example:
+Each method accepts optional `options`, `config`, and (for multi-provider methods) `mix` parameters to customize behavior.  
+For NVIDIA on DeepSeek V4 Pro, use `deepseekV4Pro({ mix: { nvidia: true } })`.
+For Together on Qwen 3.6 Plus, use `qwen36plus({ mix: { fireworks: false, together: true } })`.
 
 ```javascript
 const result = await ModelMix.new({ 

package/demo/grok.js

@@ -13,7 +13,7 @@ const mmix = new ModelMix({
 });
 
 
-const r = await mmix.grok4()
+const r = await mmix.grok43()
     .addText('hi there!')
     .addText('do you like cats?')
     .raw();

package/demo/nvidia.js

@@ -0,0 +1,15 @@
+import { ModelMix } from '../index.js';
+try { process.loadEnvFile(); } catch { }
+
+const model = ModelMix.new()
+    .deepseekV4Flash()
+    .addText("Create exactly 5 characters for a narrative game.")
+
+const jsonResult = await model.json([], [{
+    name: "character name",
+    role: "role in the story",
+    trait: "main trait",
+    goal: "short character goal"
+}]);
+
+console.log(jsonResult);

package/demo/short.js

@@ -13,7 +13,7 @@ const mmix = await ModelMix.new(setup)
     .o4mini() // (fallback 1) OpenAI o4-mini
     .gemini25proExp({ config: { temperature: 0 } }) // (fallback 2) Google gemini-2.5-pro-exp-03-25
     .gpt41nano() // (fallback 3) OpenAI gpt-4.1-nano
-    .grok3mini() // (fallback 4) Grok grok-3-mini-beta
+    .grok43() // (fallback 4) Grok grok-4.3
     .addText("What's your name?");
 
 console.log(await mmix.message());

package/index.js

@@ -73,19 +73,23 @@ const MODEL_PRICING = {
     'gemini-2.5-flash': [0.30, 2.50],
     'gemini-3.1-flash-lite-preview': [0.25, 1.50],
     // Grok
-    'grok-4-0709': [3.00, 15.00],
+    'grok-4.3': [1.25, 2.50],
+    'grok-4.20-multi-agent-0309': [1.25, 2.50],
+    'grok-4.20-0309-reasoning': [1.25, 2.50],
+    'grok-4.20-0309-non-reasoning': [1.25, 2.50],
     'grok-4-1-fast-reasoning': [0.20, 0.50],
     'grok-4-1-fast-non-reasoning': [0.20, 0.50],
     // Fireworks
     'accounts/fireworks/models/deepseek-v3p2': [0.56, 1.68],
     'accounts/fireworks/models/deepseek-v4-pro': [1.74, 3.48],
+    'deepseek-ai/DeepSeek-V4-Pro': [2.10, 4.40],
     'accounts/fireworks/models/glm-4p7': [0.55, 2.19],
     'accounts/fireworks/models/glm-5p1': [1.05, 3.50],
     'accounts/fireworks/models/kimi-k2p5': [0.50, 2.80],
     'accounts/fireworks/models/qwen3p6-plus': [0.50, 3.00],
+    'Qwen/Qwen3.6-Plus': [0.50, 3.00],
     'fireworks/glm-5': [1.00, 3.20],
     // MiniMax
-    'MiniMax-M2.1': [0.30, 1.20],
     'MiniMax-M2.5': [0.30, 1.20],
     'MiniMax-M2.7': [0.30, 1.20],
     'fireworks/minimax-m2p5': [0.30, 1.20],
@@ -421,14 +425,17 @@ class ModelMix {
         return this.attach('sonar', new MixPerplexity({ options, config }));
     }
 
-    grok3({ options = {}, config = {} } = {}) {
-        return this.attach('grok-3', new MixGrok({ options, config }));
+    grok43({ options = {}, config = {} } = {}) {
+        return this.attach('grok-4.3', new MixGrok({ options, config }));
     }
-    grok3mini({ options = {}, config = {} } = {}) {
-        return this.attach('grok-3-mini', new MixGrok({ options, config }));
+    grok420multiAgent({ options = {}, config = {} } = {}) {
+        return this.attach('grok-4.20-multi-agent-0309', new MixGrok({ options, config }));
     }
-    grok4({ options = {}, config = {} } = {}) {
-        return this.attach('grok-4-0709', new MixGrok({ options, config }));
+    grok420think({ options = {}, config = {} } = {}) {
+        return this.attach('grok-4.20-0309-reasoning', new MixGrok({ options, config }));
+    }
+    grok420({ options = {}, config = {} } = {}) {
+        return this.attach('grok-4.20-0309-non-reasoning', new MixGrok({ options, config }));
     }
     grok41think({ options = {}, config = {} } = {}) {
         return this.attach('grok-4-1-fast-reasoning', new MixGrok({ options, config }));
@@ -443,8 +450,11 @@ class ModelMix {
         return this;
     }
 
-    qwen36plus({ options = {}, config = {}, mix = { } } = {}) {
-        return this.attach('accounts/fireworks/models/qwen3p6-plus', new MixFireworks({ options, config }));
+    qwen36plus({ options = {}, config = {}, mix = { fireworks: true } } = {}) {
+        mix = { ...this.mix, ...mix };
+        if (mix.fireworks) this.attach('accounts/fireworks/models/qwen3p6-plus', new MixFireworks({ options, config }));
+        if (mix.together) this.attach('Qwen/Qwen3.6-Plus', new MixTogether({ options, config }));
+        return this;
     } 
 
     scout({ options = {}, config = {}, mix = {} } = {}) {
@@ -497,16 +507,6 @@ class ModelMix {
         return this.attach(model, new MixLMStudio({ options, config }));
     }
 
-    minimaxM2({ options = {}, config = {} } = {}) {
-        return this.attach('MiniMax-M2', new MixMiniMax({ options, config }));
-    }
-
-    minimaxM21({ options = {}, config = {}, mix = { minimax: true } } = {}) {
-        mix = { ...this.mix, ...mix };
-        if (mix.minimax) this.attach('MiniMax-M2.1', new MixMiniMax({ options, config }));
-        if (mix.cerebras) this.attach('MiniMax-M2.1', new MixCerebras({ options, config }));
-        return this;
-    }
 
     minimaxM25({ options = {}, config = {}, mix = { minimax: true } } = {}) {
         mix = { ...this.mix, ...mix };
@@ -515,11 +515,9 @@ class ModelMix {
         return this;
     }
 
-    minimaxM2Stable({ options = {}, config = {} } = {}) {
-        return this.attach('MiniMax-M2-Stable', new MixMiniMax({ options, config }));
-    }
-
     minimaxM27({ options = {}, config = {}, mix = { openrouter: true, minimax: true } } = {}) {
+        mix = { ...this.mix, ...mix };
+        if (mix.nvidia) this.attach('minimaxai/minimax-m2.7', new MixNVIDIA({ options, config }));
         if (mix.openrouter) return this.attach('minimax/minimax-m2.7', new MixOpenRouter({ options, config }));
         if (mix.minimax) return this.attach('MiniMax-M2.7', new MixMiniMax({ options, config }));
         if (mix.together) return this.attach('MiniMaxAI/MiniMax-M2.7', new MixTogether({ options, config }));
@@ -528,14 +526,22 @@ class ModelMix {
 
     deepseekV4Pro({ options = {}, config = {}, mix = { fireworks: true } } = {}) {
         mix = { ...this.mix, ...mix };
+        if (mix.nvidia) this.attach('deepseek-ai/deepseek-v4-pro', new MixNVIDIA({ options, config }));
         if (mix.fireworks) this.attach('accounts/fireworks/models/deepseek-v4-pro', new MixFireworks({ options, config }));
         if (mix.openrouter) this.attach('deepseek/deepseek-v4-pro', new MixOpenRouter({ options, config }));
         if (mix.together) this.attach('deepseek-ai/DeepSeek-V4-Pro', new MixTogether({ options, config }));
         return this;
     }
 
+    deepseekV4Flash({ options = {}, config = {}, mix = { nvidia: true } } = {}) {
+        mix = { ...this.mix, ...mix };
+        if (mix.nvidia) this.attach('deepseek-ai/deepseek-v4-flash', new MixNVIDIA({ options, config }));
+        return this;
+    }    
+
     GLM51({ options = {}, config = {}, mix = { fireworks: true } } = {}) {
         mix = { ...this.mix, ...mix };
+        if (mix.nvidia) this.attach('z-ai/glm-5.1', new MixNVIDIA({ options, config }));
         if (mix.fireworks) this.attach('accounts/fireworks/models/glm-5p1', new MixFireworks({ options, config }));
         if (mix.openrouter) this.attach('z-ai/glm-5.1', new MixOpenRouter({ options, config }));
         if (mix.together) this.attach('zai-org/GLM-5.1', new MixTogether({ options, config }));
@@ -2549,6 +2555,21 @@ class MixFireworks extends MixCustom {
     }
 }
 
+class MixNVIDIA extends MixCustom {
+    getDefaultConfig(customConfig) {
+
+        if (!process.env.NVIDIA_API_KEY) {
+            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,
+            ...customConfig
+        });
+    }
+}
+
 class MixGoogle extends MixCustom {
     getDefaultConfig(customConfig) {
         return super.getDefaultConfig({
@@ -2825,4 +2846,4 @@ class MixGoogle extends MixCustom {
     }
 }
 
-module.exports = { MixCustom, ModelMix, MixAnthropic, MixMiniMax, MixOpenAI, MixOpenAIResponses, MixOpenAIWebSocket, MixOpenRouter, MixPerplexity, MixOllama, MixLMStudio, MixGroq, MixTogether, MixGrok, MixCerebras, MixGoogle, MixFireworks };
+module.exports = { MixCustom, ModelMix, MixAnthropic, MixMiniMax, MixOpenAI, MixOpenAIResponses, MixOpenAIWebSocket, MixOpenRouter, MixPerplexity, MixOllama, MixLMStudio, MixGroq, MixTogether, MixGrok, MixCerebras, MixGoogle, MixFireworks, MixNVIDIA };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modelmix",
-  "version": "4.5.12",
+  "version": "4.5.16",
   "description": "🧬 Reliable interface with automatic fallback for AI LLMs.",
   "main": "index.js",
   "repository": {

package/skills/modelmix/SKILL.md

@@ -104,7 +104,7 @@ Thinking variants: append `think` — e.g. `opus46think()` `sonnet46think()` `so
 `gemini3pro()` `gemini3flash()` `gemini25pro()` `gemini25flash()`
 
 ### Grok
-`grok4()` `grok41()` `grok41think()` `grok3()` `grok3mini()`
+`grok43()` `grok420multiAgent()` `grok420()` `grok420think()` `grok41()` `grok41think()`
 
 ### Perplexity
 `sonar()` `sonarPro()`
@@ -113,10 +113,10 @@ Thinking variants: append `think` — e.g. `opus46think()` `sonnet46think()` `so
 `scout()` `maverick()`
 
 ### Together
-`qwen3()` `kimiK25think()` `gptOss()`
+`qwen36plus()` `kimiK25think()` `gptOss()`
 
 ### MiniMax
-`minimaxM25()` `minimaxM21()` `minimaxM2()` `minimaxM2Stable()`
+`minimaxM25()` `minimaxM27()`
 
 ### Fireworks
 `deepseekV32()` `GLM5()` `GLM47()`

package/test/deepseek.test.js

@@ -0,0 +1,20 @@
+const { expect } = require('chai');
+const { ModelMix } = require('../index.js');
+
+describe('DeepSeek Model Registration Tests', () => {
+    it('should register Fireworks DeepSeek V4 Pro by default', () => {
+        const model = ModelMix.new();
+        model.deepseekV4Pro({ mix: { fireworks: true, openrouter: false } });
+
+        expect(model.models).to.have.length(1);
+        expect(model.models[0].key).to.equal('accounts/fireworks/models/deepseek-v4-pro');
+    });
+
+    it('should register Together DeepSeek V4 Pro when together mix is enabled', () => {
+        const model = ModelMix.new();
+        model.deepseekV4Pro({ mix: { fireworks: false, openrouter: false, together: true } });
+
+        expect(model.models).to.have.length(1);
+        expect(model.models[0].key).to.equal('deepseek-ai/DeepSeek-V4-Pro');
+    });
+});

package/test/grok.test.js

@@ -0,0 +1,21 @@
+const { expect } = require('chai');
+const { ModelMix } = require('../index.js');
+
+describe('Grok Model Registration Tests', () => {
+    const grokModels = [
+        { method: 'grok43', key: 'grok-4.3' },
+        { method: 'grok420multiAgent', key: 'grok-4.20-multi-agent-0309' },
+        { method: 'grok420think', key: 'grok-4.20-0309-reasoning' },
+        { method: 'grok420', key: 'grok-4.20-0309-non-reasoning' }
+    ];
+
+    for (const grokModel of grokModels) {
+        it(`should register ${grokModel.key} with ${grokModel.method}()`, () => {
+            const model = ModelMix.new();
+            model[grokModel.method]();
+
+            expect(model.models).to.have.length(1);
+            expect(model.models[0].key).to.equal(grokModel.key);
+        });
+    }
+});

package/test/live.mcp.js

@@ -191,8 +191,8 @@ describe('Live MCP Integration Tests', function () {
 
     describe('Advanced MCP Tool Integration', function () {
 
-        it('should use multiple MCP tools with Grok 3 Mini', async function () {
-            const model = ModelMix.new(setup).grok3mini();
+        it('should use multiple MCP tools with Grok 4.3', async function () {
+            const model = ModelMix.new(setup).grok43();
 
             // Add multiple tools
             model.addTools([

package/test/live.test.js

@@ -204,18 +204,38 @@ describe('Live Integration Tests', function () {
             expect(response.toLowerCase()).to.include('gptoss test successful');
         });
 
-        it('should work with Grok3Mini model', async function () {
-            const model = ModelMix.new(setup).grok3mini();
+        it('should work with Grok 4.1 model', async function () {
+            const model = ModelMix.new(setup).grok41();
 
-            model.addText('Say "grok3mini test successful" and nothing else.');
+            model.addText('Say "grok41 test successful" and nothing else.');
 
             const response = await model.message();
-            console.log(`Grok3Mini response: ${response}`);
+            console.log(`Grok 4.1 response: ${response}`);
 
             expect(response).to.be.a('string');
-            expect(response.toLowerCase()).to.include('grok3mini test successful');
+            expect(response.toLowerCase()).to.include('grok41 test successful');
         });
 
+        const grokSeriesTests = [
+            { name: 'Grok 4.3', factory: (m) => m.grok43(), token: 'grok43' },
+            { name: 'Grok 4.20 reasoning', factory: (m) => m.grok420think(), token: 'grok420think' },
+            { name: 'Grok 4.20 non-reasoning', factory: (m) => m.grok420(), token: 'grok420' }
+        ];
+
+        for (const grokModel of grokSeriesTests) {
+            it(`should work with ${grokModel.name} model`, async function () {
+                const model = grokModel.factory(ModelMix.new(setup));
+
+                model.addText(`Say "${grokModel.token} test successful" and nothing else.`);
+
+                const response = await model.message();
+                console.log(`${grokModel.name} response: ${response}`);
+
+                expect(response).to.be.a('string');
+                expect(response.toLowerCase()).to.include(`${grokModel.token} test successful`);
+            });
+        }
+
     });
 
     describe('Image Processing with JSON Output', function () {
@@ -240,8 +260,8 @@ describe('Live Integration Tests', function () {
             expect(result.color).to.be.a('string').and.not.empty;
         });
 
-        it('should process images and return JSON with Grok 4', async function () {
-            const model = ModelMix.new(setup).grok4();
+        it('should process images and return JSON with Grok 4.3', async function () {
+            const model = ModelMix.new(setup).grok43();
 
             model.addImageFromUrl(blueSquareBase64)
                 .addText('Analyze this image and provide details in JSON format.');
@@ -252,7 +272,7 @@ describe('Live Integration Tests', function () {
                 description: "string"
             });
 
-            console.log(`Grok3Mini image JSON result:`, result);
+            console.log(`Grok 4.3 image JSON result:`, result);
 
             expect(result).to.be.an('object');
             expect(result).to.have.property('color');

package/test/qwen.test.js

@@ -0,0 +1,20 @@
+const { expect } = require('chai');
+const { ModelMix } = require('../index.js');
+
+describe('Qwen Model Registration Tests', () => {
+    it('should register Fireworks Qwen 3.6 Plus by default', () => {
+        const model = ModelMix.new();
+        model.qwen36plus({ mix: { fireworks: true, together: false } });
+
+        expect(model.models).to.have.length(1);
+        expect(model.models[0].key).to.equal('accounts/fireworks/models/qwen3p6-plus');
+    });
+
+    it('should register Together Qwen 3.6 Plus when together mix is enabled', () => {
+        const model = ModelMix.new();
+        model.qwen36plus({ mix: { fireworks: false, openrouter: false, together: true } });
+
+        expect(model.models).to.have.length(1);
+        expect(model.models[0].key).to.equal('Qwen/Qwen3.6-Plus');
+    });
+});

package/test/setup.js

@@ -29,6 +29,7 @@ process.env.GROQ_API_KEY = process.env.GROQ_API_KEY || 'gsk_test-dummy-key-for-t
 process.env.TOGETHER_API_KEY = process.env.TOGETHER_API_KEY || '49a96test-dummy-key-for-testing-purposes';
 process.env.XAI_API_KEY = process.env.XAI_API_KEY || 'xai-test-dummy-key-for-testing-purposes';
 process.env.CEREBRAS_API_KEY = process.env.CEREBRAS_API_KEY || 'csk-test-dummy-key-for-testing-purposes';
+process.env.NVIDIA_API_KEY = process.env.NVIDIA_API_KEY || 'nvapi-test-dummy-key-for-testing-purposes';
 process.env.GEMINI_API_KEY = process.env.GEMINI_API_KEY || 'AIzatest-dummy-key-for-testing-purposes';
 process.env.LAMBDA_API_KEY = process.env.LAMBDA_API_KEY || 'secret_test-dummy-key-for-testing-purposes';
 process.env.BRAVE_API_KEY = process.env.BRAVE_API_KEY || 'BSA0test-dummy-key-for-testing-purposes_fm';