modelmix 5.1.6 → 5.1.8

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/package.json

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

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