modelmix 4.5.12 → 4.5.14

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..."
 ```
@@ -166,7 +167,7 @@ Here's a comprehensive list of available methods:
 | `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 +180,8 @@ 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, fireworks: false } })`.
 
 ```javascript
 const result = await ModelMix.new({ 

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/index.js

@@ -520,6 +520,8 @@ class ModelMix {
     }
 
     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 +530,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 +2559,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 +2850,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.14",
   "description": "🧬 Reliable interface with automatic fallback for AI LLMs.",
   "main": "index.js",
   "repository": {

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';