modelmix 5.1.9 → 5.1.12

package/README.md

@@ -119,10 +119,9 @@ console.log(ETH.price);
 
 **This example uses providers with free quotas (Groq, Cerebras, and Together). OpenRouter is disabled because its GPT-OSS 120B route is no longer free. If one model runs out of quota, ModelMix automatically falls back to the next model in the chain.**
 ```javascript
-ModelMix.new({ mix: { openrouter: false } })
+ModelMix.new()
   .gptOss()
   .kimiK25()
-  .hermes3()
   .addText('What is the capital of France?');
 ```
 
@@ -143,15 +142,20 @@ ModelMix provides convenient shorthand methods for quickly accessing different A
 | `gpt56terra()` | OpenAI | gpt-5.6-terra | [\$2.00][1] | [\$12.00][1] |
 | `gpt56luna()` | OpenAI | gpt-5.6-luna | [\$0.20][1] | [\$1.20][1] |
 | `gpt55()` | OpenAI | gpt-5.5 | [\$5.00][1] | [\$30.00][1] |
+| `gpt55pro()` | OpenAI | gpt-5.5-pro | [\$30.00][1] | [\$180.00][1] |
 | `gpt54()` | OpenAI | gpt-5.4 | [\$2.50][1] | [\$15.00][1] |
 | `gpt54mini()` | OpenAI | gpt-5.4-mini | [\$0.75][1] | [\$4.50][1] |
 | `gpt54nano()` | OpenAI | gpt-5.4-nano | [\$0.20][1] | [\$1.25][1] |
-| `gpt53codex()` | OpenAI | gpt-5.3-codex | [\$1.25][1] | [\$14.00][1] |
+| `gpt54pro()` | OpenAI | gpt-5.4-pro | [\$30.00][1] | [\$180.00][1] |
+| `gpt53codex()` | OpenAI | gpt-5.3-codex | [\$1.75][1] | [\$14.00][1] |
+| `gpt53chat()` | OpenAI | gpt-5.3-chat-latest | [\$1.75][1] | [\$14.00][1] |
 | `gpt52()` | OpenAI | gpt-5.2 | [\$1.75][1] | [\$14.00][1] |
 | `gpt51()` | OpenAI | gpt-5.1 | [\$1.25][1] | [\$10.00][1] |
+| `gpt5()` | OpenAI | gpt-5 | [\$1.25][1] | [\$10.00][1] |
 | `gpt5mini()` | OpenAI | gpt-5-mini | [\$0.25][1] | [\$2.00][1] |
 | `gpt5nano()` | OpenAI | gpt-5-nano | [\$0.05][1] | [\$0.40][1] |
-| `gptOss()` | Cerebras/Groq/OpenRouter | gpt-oss-120B | [\$0.15][7] | [\$0.60][7] |
+| `gptOss()` | Multi-provider | gpt-oss-120B | [\$0.15][7] | [\$0.60][7] |
+| `fable51()` | Anthropic | claude-fable-5-1 | [\$10.00][2] | [\$50.00][2] |
 | `fable5()` | Anthropic | claude-fable-5 | [\$10.00][2] | [\$50.00][2] |
 | `opus5()` | Anthropic | claude-opus-5 | [\$5.00][2] | [\$25.00][2] |
 | `opus48()` | Anthropic | claude-opus-4-8 | [\$5.00][2] | [\$25.00][2] |
@@ -172,6 +176,7 @@ ModelMix provides convenient shorthand methods for quickly accessing different A
 | `grok420multiAgent()` | Grok | grok-4.20-multi-agent-0309 | [\$1.25][6] | [\$2.50][6] |
 | `grok420()` | Grok | grok-4.20-0309 (†) | [\$1.25][6] | [\$2.50][6] |
 | `museGlimmer30b()` | Fireworks | models/muse-glimmer-30b | [\$0.35][17] | [\$1.50][17] |
+| `museSpark12Contributor()` | OpenRouter | meta/muse-spark-1.2-contributor | [\$0.10][22] | [\$0.20][22] |
 | `qwen35397b()` | OpenRouter | qwen/qwen3.5-397b-a17b | [\$0.385][14] | [\$2.45][14] |
 | `qwen36plus()` | OpenRouter | qwen/qwen3.6-plus | [\$0.325][18] | [\$1.95][18] |
 | `qwen37plus()` | Fireworks | models/qwen3p7-plus | [\$0.40][10] | [\$1.60][10] |
@@ -197,9 +202,13 @@ ModelMix provides convenient shorthand methods for quickly accessing different A
 
 Gemini 3.7 Flash and 3.6 Flash use Google's introductory standard pricing through December 31, 2026; standard rates double on January 1, 2027.
 
-`museGlimmer30b()` uses Fireworks first and OpenRouter as its default fallback. NVIDIA NIM and Together are also available through `mix.nvidia` and `mix.together`; disable either default provider with `mix.fireworks: false` or `mix.openrouter: false`.
+`museGlimmer30b()` uses Fireworks by default. OpenRouter, NVIDIA NIM, and Together are available through `mix.openrouter`, `mix.nvidia`, and `mix.together`.
 
-The multi-provider shortcuts also expose the current catalog alternatives: `gptOss()` supports NVIDIA and Fireworks; `qwen37plus()` supports Together; `kimiK27Code()` supports Fireworks and OpenRouter; `kimiK3()` supports Fireworks, OpenRouter, and Together; `GLM52()` supports Fireworks and OpenRouter; and both MiniMax shortcuts support Fireworks. `minimaxM27()` keeps every enabled provider in its fallback chain. `qwen36plus()` now defaults to OpenRouter because Fireworks retired its serverless deployment; Fireworks remains available explicitly for private or on-demand deployments.
+`fable51()` uses the official Anthropic API by default (`claude-fable-5-1`). Pass `mix: { openrouter: true }` to append [`anthropic/claude-fable-5.1`][21] as its fallback.
+
+Every textual GPT-5 shortcut in the table uses the official OpenAI API by default. Pass `mix: { openrouter: true }` to `ModelMix.new()` or to an individual shortcut to append the matching [`openai/*` OpenRouter route][23] as its fallback. `gpt53chat()` maps the official `gpt-5.3-chat-latest` alias to `openai/gpt-5.3-chat`. Realtime shortcuts remain official-only because they use OpenAI's WebSocket transport.
+
+OpenRouter fallbacks are disabled globally by default and are appended only with `mix.openrouter: true`. Shortcuts whose primary provider is OpenRouter, such as `qwen36plus()`, are unaffected. The multi-provider shortcuts also expose the current catalog alternatives: `gptOss()` supports NVIDIA and Fireworks; `qwen37plus()` supports Together; `kimiK27Code()` supports Fireworks and OpenRouter; `kimiK3()` supports Fireworks, OpenRouter, and Together; `GLM52()` supports Fireworks and OpenRouter; and both MiniMax shortcuts support Fireworks. `minimaxM27()` keeps every explicitly enabled provider in its fallback chain.
 
 [1]: https://platform.openai.com/docs/pricing "Pricing | OpenAI"
 [2]: https://docs.anthropic.com/en/docs/about-claude/pricing "Pricing - Anthropic"
@@ -221,6 +230,9 @@ The multi-provider shortcuts also expose the current catalog alternatives: `gptO
 [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"
+[21]: https://openrouter.ai/anthropic/claude-fable-5.1 "Claude Fable 5.1 on OpenRouter"
+[22]: https://openrouter.ai/meta/muse-spark-1.2-contributor "Muse Spark 1.2 Contributor on OpenRouter"
+[23]: https://openrouter.ai/openai "OpenAI Models on OpenRouter"
 
 Each method accepts optional `options`, `config`, and (for multi-provider methods) `mix` parameters to customize behavior.  
 

package/demo/free.js

@@ -1,12 +1,10 @@
 import { ModelMix } from '../index.js';
 try { process.loadEnvFile(); } catch {}
 
-const ai = ModelMix.new({ config: { debug: 2 }, mix: { openrouter: false } })
+const ai = ModelMix.new({ config: { debug: 2 } })
     .gptOss()
     .kimiK25()
-    .hermes3()
     .addText('What is the capital of France?');
 
 const response = await ai.message();
 console.log('Response from a free-tier provider:', response);
-

package/demo/short.js

@@ -9,19 +9,21 @@ const setup = {
 };
 
 const mmix = await ModelMix.new(setup)
-    .sonnet46() // (main model) Anthropic claude-sonnet-4-6
-    .gpt56luna() // (fallback 1) OpenAI gpt-5.6-luna
-    .gemini37flash() // (fallback 2) Google gemini-3.7-flash
-    .gpt5nano() // (fallback 3) OpenAI gpt-5-nano
-    .grok46() // (fallback 4) Grok grok-4.6
-    .qwen35397b() // (fallback 5) OpenRouter qwen/qwen3.5-397b-a17b
-    .qwen3827b() // (fallback 6) OpenRouter qwen/qwen3.8-27b
-    .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
+    .fable51({ mix: { openrouter: true } }) // (main + provider fallback) Anthropic/OpenRouter Claude Fable 5.1
+    .sonnet46() // (fallback 2) Anthropic claude-sonnet-4-6
+    .gpt56luna({ mix: { openrouter: true } }) // (fallback 3 + provider fallback) OpenAI/OpenRouter gpt-5.6-luna
+    .gemini37flash() // (fallback 4) Google gemini-3.7-flash
+    .gpt5nano({ mix: { openrouter: true } }) // (fallback 5 + provider fallback) OpenAI/OpenRouter gpt-5-nano
+    .grok46() // (fallback 6) Grok grok-4.6
+    .qwen35397b() // (fallback 7) OpenRouter qwen/qwen3.5-397b-a17b
+    .qwen3827b() // (fallback 8) OpenRouter qwen/qwen3.8-27b
+    .qwen38flash() // (fallback 9) OpenRouter qwen/qwen3.8-flash
+    .GLM53() // (fallback 10) OpenRouter z-ai/glm-5.3
+    .GLM53Flash() // (fallback 11) OpenRouter z-ai/glm-5.3-flash
+    .museGlimmer30b({ mix: { fireworks: false, openrouter: true } }) // (fallback 12) OpenRouter meta/muse-glimmer-30b
+    .museSpark12Contributor() // (fallback 13) OpenRouter meta/muse-spark-1.2-contributor
+    .hermes470b() // (fallback 14) OpenRouter nousresearch/hermes-4-70b
+    .hermes4405b() // (fallback 15) OpenRouter nousresearch/hermes-4-405b
     .addText("What's your name?");
 
 console.log(await mmix.message());

package/effort.js

@@ -7,7 +7,7 @@
  */
 
 const OPENAI_LEVELS = ['none', 'low', 'medium', 'high', 'xhigh'];
-const OPENAI_LEVEL_LADDER = [...OPENAI_LEVELS, 'max'];
+const OPENAI_LEVEL_LADDER = ['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
 const ANTHROPIC_LEVELS = ['low', 'medium', 'high', 'xhigh', 'max'];
 const GEMINI_LEVELS = ['minimal', 'low', 'medium', 'high'];
 
@@ -45,9 +45,11 @@ const OPENAI_MODEL_LEVELS = {
     'gpt-5.6-sol': ['none', 'low', 'medium', 'high', 'xhigh', 'max'],
     'gpt-5.6-terra': ['none', 'low', 'medium', 'high', 'xhigh', 'max'],
     'gpt-5.6-luna': ['none', 'low', 'medium', 'high', 'xhigh', 'max'],
+    'anthropic/claude-fable-5.1': ['low', 'medium', 'high', 'xhigh', 'max'],
     'meta/muse-glimmer-30b': ['low', 'medium', 'high'],
     'accounts/fireworks/models/muse-glimmer-30b': ['low', 'medium', 'high', 'xhigh'],
     'meta-models/Muse-Glimmer-30B': ['low', 'medium', 'high', 'xhigh'],
+    'meta/muse-spark-1.2-contributor': ['minimal', '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'],
@@ -87,7 +89,6 @@ const DEEPSEEK_BANDS = [
  * MiniMax M3 (OpenAI-compatible): thinking.type disabled | adaptive.
  * @see https://platform.minimax.io/docs/api-reference/text-openai-api
  */
-const MINIMAX_LEVELS = ['disabled', 'adaptive'];
 const MINIMAX_BANDS = [
     [0, 19, 'disabled'],
     [20, 100, 'adaptive'],
@@ -203,8 +204,11 @@ function pickNearestLevel(desired, ladder, supported) {
 }
 
 function supportedOpenAILevels(modelKey) {
-    if (modelKey && OPENAI_MODEL_LEVELS[modelKey]) {
-        return OPENAI_MODEL_LEVELS[modelKey];
+    const canonicalModelKey = typeof modelKey === 'string' && modelKey.startsWith('openai/')
+        ? modelKey.slice('openai/'.length)
+        : modelKey;
+    if (canonicalModelKey && OPENAI_MODEL_LEVELS[canonicalModelKey]) {
+        return OPENAI_MODEL_LEVELS[canonicalModelKey];
     }
     return OPENAI_LEVELS;
 }
@@ -400,9 +404,11 @@ function mapEffort(providerFamily, effort, modelKey) {
         const supported = supportedOpenAILevels(modelKey);
         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'
-                : levelFromBands(normalized, OPENAI_BANDS);
+            : modelKey === 'anthropic/claude-fable-5.1'
+                ? levelFromBands(normalized, ANTHROPIC_BANDS)
+                : normalized === 100 && supported.includes('max')
+                    ? 'max'
+                    : levelFromBands(normalized, OPENAI_BANDS);
         const level = pickNearestLevel(desired, OPENAI_LEVEL_LADDER, supported);
         return { reasoning_effort: level };
     }

package/index.d.ts

@@ -76,6 +76,7 @@ export interface ModelMixConfig {
 }
 
 export interface ModelMixMixFlags {
+  anthropic?: boolean;
   openrouter?: boolean;
   cerebras?: boolean;
   groq?: boolean;
@@ -462,6 +463,7 @@ export declare class ModelMix {
   gptOss(args?: ModelAttachArgs): this;
 
   // Anthropic
+  fable51(args?: ModelAttachArgs): this;
   fable50(args?: ModelAttachArgs): this;
   fable5(args?: ModelAttachArgs): this;
   opus50(args?: ModelAttachArgs): this;
@@ -497,6 +499,7 @@ export declare class ModelMix {
 
   // Multi-provider
   museGlimmer30b(args?: ModelAttachArgs): this;
+  museSpark12Contributor(args?: ModelAttachArgs): this;
   qwen35397b(args?: ModelAttachArgs): this;
   qwen36plus(args?: ModelAttachArgs): this;
   qwen37plus(args?: ModelAttachArgs): this;

package/index.js

@@ -144,7 +144,7 @@ class ModelMix {
         if (this.config.effort !== undefined && this.config.effort !== null) {
             this.config.effort = normalizeEffort(this.config.effort);
         }
-        const freeMix = { openrouter: true, cerebras: true, groq: true, together: false, lambda: false };
+        const freeMix = { openrouter: false, cerebras: true, groq: true, together: false, lambda: false };
         this.mix = { ...freeMix, ...mix };
 
         this.limiter = new Bottleneck(this.config.bottleneck);
@@ -434,47 +434,59 @@ class ModelMix {
         return this;
     }
 
-    gpt5({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5', new MixOpenAI({ options, config }));
+    _attachOpenAIWithOpenRouter(officialKey, Provider, {
+        options = {},
+        config = {},
+        mix = {},
+        openRouterKey = `openai/${officialKey}`
+    } = {}) {
+        mix = { ...this.mix, ...mix };
+        this.attach(officialKey, new Provider({ options, config }));
+        if (mix.openrouter) this.attach(openRouterKey, new MixOpenRouter({ options, config }));
+        return this;
     }
-    gpt5mini({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5-mini', new MixOpenAI({ options, config }));
+
+    gpt5(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5', MixOpenAI, args);
+    }
+    gpt5mini(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5-mini', MixOpenAI, args);
+    }
+    gpt5nano(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5-nano', MixOpenAI, args);
     }
-    gpt5nano({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5-nano', new MixOpenAI({ options, config }));
+    gpt51(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.1', MixOpenAIResponses, args);
     }
-    gpt51({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.1', new MixOpenAIResponses({ options, config }));
+    gpt52(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.2', MixOpenAIResponses, args);
     }
-    gpt52({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.2', new MixOpenAIResponses({ options, config }));
+    gpt54(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.4', MixOpenAIResponses, args);
     }
-    gpt54({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.4', new MixOpenAIResponses({ options, config }));
+    gpt54mini(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.4-mini', MixOpenAIResponses, args);
     }
-    gpt54mini({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.4-mini', new MixOpenAIResponses({ options, config }));
+    gpt54nano(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.4-nano', MixOpenAIResponses, args);
     }
-    gpt54nano({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.4-nano', new MixOpenAIResponses({ options, config }));
-    }        
-    gpt54pro({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.4-pro', new MixOpenAIResponses({ options, config }));
+    gpt54pro(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.4-pro', MixOpenAIResponses, args);
     }
-    gpt55({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.5', new MixOpenAIResponses({ options, config }));
+    gpt55(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.5', MixOpenAIResponses, args);
     }
-    gpt55pro({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.5-pro', new MixOpenAIResponses({ options, config }));
+    gpt55pro(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.5-pro', MixOpenAIResponses, args);
     }
-    gpt56sol({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.6-sol', new MixOpenAIResponses({ options, config }));
+    gpt56sol(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.6-sol', MixOpenAIResponses, args);
     }
-    gpt56terra({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.6-terra', new MixOpenAIResponses({ options, config }));
+    gpt56terra(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.6-terra', MixOpenAIResponses, args);
     }
-    gpt56luna({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.6-luna', new MixOpenAIResponses({ options, config }));
+    gpt56luna(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.6-luna', MixOpenAIResponses, args);
     }
     gptRealtime({ options = {}, config = {} } = {}) {
         return this.attach('gpt-realtime', new MixOpenAIWebSocket({ options, config }));
@@ -482,11 +494,14 @@ class ModelMix {
     gptRealtimeMini({ options = {}, config = {} } = {}) {
         return this.attach('gpt-realtime-mini', new MixOpenAIWebSocket({ options, config }));
     }
-    gpt53codex({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.3-codex', new MixOpenAIResponses({ options, config }));
-    }          
-    gpt53chat({ options = {}, config = {} } = {}) {
-        return this.attach('gpt-5.3-chat-latest', new MixOpenAIResponses({ options, config }));
+    gpt53codex(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.3-codex', MixOpenAIResponses, args);
+    }
+    gpt53chat(args = {}) {
+        return this._attachOpenAIWithOpenRouter('gpt-5.3-chat-latest', MixOpenAIResponses, {
+            ...args,
+            openRouterKey: 'openai/gpt-5.3-chat'
+        });
     }
     gptOss({ options = {}, config = {}, mix = {} } = {}) {
         mix = { ...this.mix, ...mix };
@@ -504,6 +519,12 @@ class ModelMix {
     fable5(args = {}) {
         return this.fable50(args);
     }
+    fable51({ options = {}, config = {}, mix = {} } = {}) {
+        mix = { anthropic: true, ...this.mix, ...mix };
+        if (mix.anthropic) this.attach('claude-fable-5-1', new MixAnthropic({ options, config }));
+        if (mix.openrouter) this.attach('anthropic/claude-fable-5.1', new MixOpenRouter({ options, config }));
+        return this;
+    }
     opus50({ options = {}, config = {} } = {}) {
         return this.attach('claude-opus-5', new MixAnthropic({ options, config }));
     }
@@ -585,6 +606,10 @@ class ModelMix {
         return this;
     }
 
+    museSpark12Contributor({ options = {}, config = {} } = {}) {
+        return this.attach('meta/muse-spark-1.2-contributor', new MixOpenRouter({ options, config }));
+    }
+
     qwen35397b({ options = {}, config = {} } = {}) {
         return this.attach('qwen/qwen3.5-397b-a17b', new MixOpenRouter({ options, config }));
     }
@@ -628,7 +653,7 @@ class ModelMix {
         return this.attach('nousresearch/hermes-4-405b', new MixOpenRouter({ options, config }));
     }
 
-    hermes3({ options = {}, config = {}, mix = {} } = {}) {
+    hermes3({ options = {}, config = {}, mix = { openrouter: true } } = {}) {
         mix = { ...this.mix, ...mix };
         if (mix.lambda) this.attach('Hermes-3-Llama-3.1-405B-FP8', new MixLambda({ options, config }));
         if (mix.openrouter) this.attach('nousresearch/hermes-3-llama-3.1-405b:free', new MixOpenRouter({ options, config }));
@@ -673,7 +698,7 @@ class ModelMix {
     }
 
 
-    minimaxM27({ options = {}, config = {}, mix = { openrouter: true, minimax: true } } = {}) {
+    minimaxM27({ options = {}, config = {}, mix = { minimax: true } } = {}) {
         mix = { ...this.mix, ...mix };
         if (mix.nvidia) this.attach('minimaxai/minimax-m2.7', new MixNVIDIA({ options, config }));
         if (mix.fireworks) this.attach('accounts/fireworks/models/minimax-m2p7', new MixFireworks({ options, config }));
@@ -786,22 +811,23 @@ class ModelMix {
         return this;
     }
 
-    addImageFromBuffer(buffer, { role = "user", cache } = {}) {
+    _addImageSource(source, { role = "user", cache } = {}) {
         const contentCache = normalizeContentCache(cache);
         this.messages.push({
             role,
             content: [{
                 type: "image",
-                source: {
-                    type: "buffer",
-                    data: buffer
-                },
+                source,
                 ...(contentCache !== undefined && { cache: contentCache })
             }]
         });
         return this;
     }
 
+    addImageFromBuffer(buffer, { role = "user", cache } = {}) {
+        return this._addImageSource({ type: "buffer", data: buffer }, { role, cache });
+    }
+
     addImage(filePath, { role = "user", cache } = {}) {
         const absolutePath = path.resolve(filePath);
 
@@ -809,19 +835,7 @@ class ModelMix {
             throw new Error(`Image file not found: ${filePath}`);
         }
 
-        const contentCache = normalizeContentCache(cache);
-        this.messages.push({
-            role,
-            content: [{
-                type: "image",
-                source: {
-                    type: "file",
-                    data: filePath
-                },
-                ...(contentCache !== undefined && { cache: contentCache })
-            }]
-        });
-        return this;
+        return this._addImageSource({ type: "file", data: filePath }, { role, cache });
     }
 
     addImageFromUrl(url, { role = "user", cache } = {}) {
@@ -845,17 +859,7 @@ class ModelMix {
             };
         }
 
-        const contentCache = normalizeContentCache(cache);
-        this.messages.push({
-            role,
-            content: [{
-                type: "image",
-                source,
-                ...(contentCache !== undefined && { cache: contentCache })
-            }]
-        });
-
-        return this;
+        return this._addImageSource(source, { role, cache });
     }
 
     async processImages() {
@@ -1096,10 +1100,6 @@ class ModelMix {
             const shouldNotGroup = ModelMix.hasToolInteraction(currentMessage);
 
             if (index === 0 || currentMessage.role !== messages[index - 1].role || shouldNotGroup) {
-                // acc.push({
-                //     role: currentMessage.role,
-                //     content: currentMessage.content
-                // });
                 acc.push(currentMessage);
             } else {
                 acc[acc.length - 1].content = acc[acc.length - 1].content.concat(currentMessage.content);
@@ -1865,4 +1865,4 @@ class ModelMix {
     log
 }));
 
-module.exports = { MixCustom, ModelMix, ModerationMix, MixModeration, MixAnthropic, MixKimi, MixMiniMax, MixMiMo, MixOpenAI, MixOpenAIResponses, MixOpenAIModeration, MixOpenAIWebSocket, MixOpenRouter, MixPerplexity, MixOllama, MixLMStudio, MixGroq, MixTogether, MixGrok, MixCerebras, MixGoogle, MixFireworks, MixNVIDIA, normalizeEffort, applyUnifiedEffort, resolveProviderFamily };
+module.exports = { MixCustom, ModelMix, ModerationMix, MixModeration, MixAnthropic, MixKimi, MixMiniMax, MixMiMo, MixOpenAI, MixOpenAIResponses, MixOpenAIModeration, MixOpenAIWebSocket, MixOpenRouter, MixPerplexity, MixOllama, MixLambda, MixLMStudio, MixGroq, MixTogether, MixGrok, MixCerebras, MixGoogle, MixFireworks, MixNVIDIA, normalizeEffort, applyUnifiedEffort, resolveProviderFamily };

package/lib/model-chain.js

@@ -5,12 +5,12 @@ const CHAIN_MODEL_SHORTCUTS = new Set([
     'gpt51', 'gpt52', 'gpt54', 'gpt54mini', 'gpt54nano', 'gpt54pro',
     'gpt55', 'gpt55pro', 'gpt56sol', 'gpt56terra', 'gpt56luna',
     'gptRealtime', 'gptRealtimeMini', 'gpt53codex', 'gpt53chat', 'gptOss',
-    'fable50', 'fable5', 'opus50', 'opus5', 'opus48', 'opus47', 'opus46',
+    'fable51', 'fable50', 'fable5', 'opus50', 'opus5', 'opus48', 'opus47', 'opus46',
     'sonnet50', 'sonnet5', 'sonnet46', 'sonnet45', 'haiku45',
     'gemini31pro', 'gemini37flash', 'gemini36flash', 'gemini35flash',
     'gemini35flashLite', 'gemini31flashLite', 'sonarPro', 'sonar',
     'grok46', 'grok45', 'grok43', 'grok420multiAgent', 'grok420',
-    'museGlimmer30b',
+    'museGlimmer30b', 'museSpark12Contributor',
     'qwen35397b', 'qwen36plus', 'qwen37plus', 'qwen38max', 'qwen3827b', 'qwen38flash',
     'hermes470b', 'hermes4405b', 'hermes3',
     'kimiK26', 'kimiK27Code', 'kimiK3', 'kimiK25',

package/lib/provider-api-key.js

@@ -0,0 +1,9 @@
+function requireProviderApiKey(customConfig, environmentVariable, providerName) {
+    const apiKey = customConfig.apiKey || process.env[environmentVariable];
+    if (!apiKey) {
+        throw new Error(`${providerName} API key not found. Please provide it in config or set ${environmentVariable} environment variable.`);
+    }
+    return apiKey;
+}
+
+module.exports = { requireProviderApiKey };

package/lib/providers/anthropic.js

@@ -4,6 +4,25 @@ const {
     stripContentCacheMetadata,
     hasNeutralCacheBreakpoint
 } = require('../content-cache');
+const { requireProviderApiKey } = require('../provider-api-key');
+
+function rejectsAnthropicSamplingParams(model = '') {
+    const id = String(model).toLowerCase();
+    if (!id.includes('claude')) return false;
+    if (id.includes('mythos') || id.includes('fable')) return true;
+
+    const opus = id.match(/claude-opus-(\d+)(?:-(\d+))?/);
+    if (opus) {
+        const major = Number(opus[1]);
+        const minor = opus[2] !== undefined ? Number(opus[2]) : 0;
+        return major > 4 || (major === 4 && minor >= 7);
+    }
+
+    const sonnet = id.match(/claude-sonnet-(\d+)/);
+    if (sonnet) return Number(sonnet[1]) >= 5;
+
+    return false;
+}
 
 function createAnthropicProviders({ ModelMix, MixCustom, log }) {
     class MixAnthropic extends MixCustom {
@@ -30,28 +49,11 @@ function createAnthropicProviders({ ModelMix, MixCustom, log }) {
          * See: https://platform.claude.com/docs/en/about-claude/models/migration-guide
          */
         static rejectsSamplingParams(model = '') {
-            const id = String(model).toLowerCase();
-            if (!id.includes('claude')) return false;
-            if (id.includes('mythos') || id.includes('fable')) return true;
-    
-            const opus = id.match(/claude-opus-(\d+)(?:-(\d+))?/);
-            if (opus) {
-                const major = Number(opus[1]);
-                const minor = opus[2] !== undefined ? Number(opus[2]) : 0;
-                return major > 4 || (major === 4 && minor >= 7);
-            }
-    
-            const sonnet = id.match(/claude-sonnet-(\d+)/);
-            if (sonnet) return Number(sonnet[1]) >= 5;
-    
-            return false;
+            return rejectsAnthropicSamplingParams(model);
         }
     
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'ANTHROPIC_API_KEY', 'Anthropic');
     
             return super.getDefaultConfig({
                 url: 'https://api.anthropic.com/v1/messages',
@@ -334,4 +336,4 @@ function createAnthropicProviders({ ModelMix, MixCustom, log }) {
     return { MixAnthropic };
 }
 
-module.exports = createAnthropicProviders;
+module.exports = { createAnthropicProviders, rejectsAnthropicSamplingParams };

package/lib/providers/base.js

@@ -11,6 +11,8 @@ const {
     stripContentCacheMetadata
 } = require('../content-cache');
 const { configForDebug, redactSecret } = require('../provider-debug');
+const { requireProviderApiKey } = require('../provider-api-key');
+const { normalizeOpenAIOptions } = require('./openai-options');
 
 function createBaseProviders({ ModelMix }) {
     class MixCustom {
@@ -274,10 +276,7 @@ function createBaseProviders({ ModelMix }) {
         }
     
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'OPENAI_API_KEY', 'OpenAI');
     
             return super.getDefaultConfig({
                 url: 'https://api.openai.com/v1/chat/completions',
@@ -287,22 +286,7 @@ function createBaseProviders({ ModelMix }) {
         }
     
         async create({ config = {}, options = {} } = {}) {
-    
-            // Remove max_tokens and temperature for o1/o3 models
-            if (options.model?.startsWith('o')) {
-                delete options.max_tokens;
-                delete options.temperature;
-            }
-    
-            // Use max_completion_tokens and remove temperature for GPT-5 models
-            if (options.model?.includes('gpt-5')) {
-                if (options.max_tokens) {
-                    options.max_completion_tokens = options.max_tokens;
-                    delete options.max_tokens;
-                }
-                delete options.temperature;
-            }
-    
+            normalizeOpenAIOptions(options);
             return super.create({ config, options });
         }
     
@@ -387,10 +371,8 @@ function createBaseProviders({ ModelMix }) {
                 }
             }
     
-            // Solo incluir tools si el array no está vacío
             if (toolsArray.length > 0) {
                 options.tools = toolsArray;
-                // options.tool_choice = "auto";
             }
     
             return options;

package/lib/providers/google.js

@@ -1,10 +1,11 @@
 const { fetchJsonResponse } = require('../../http-client');
 const { configForDebug } = require('../provider-debug');
+const { requireProviderApiKey } = require('../provider-api-key');
 
 function createGoogleProviders({ ModelMix, MixCustom }) {
     class MixGoogle extends MixCustom {
         getDefaultConfig(customConfig) {
-            const apiKey = customConfig.apiKey || process.env.GEMINI_API_KEY;
+            const apiKey = requireProviderApiKey(customConfig, 'GEMINI_API_KEY', 'Gemini');
             return super.getDefaultConfig({
                 url: 'https://generativelanguage.googleapis.com/v1beta/models',
                 apiKey,
@@ -19,7 +20,7 @@ function createGoogleProviders({ ModelMix, MixCustom }) {
             };
         }
     
-        static convertMessages(messages, config) {
+        static convertMessages(messages) {
             return messages.map(message => {
     
                 // Handle assistant messages with tool_calls (content is null)
@@ -122,10 +123,6 @@ function createGoogleProviders({ ModelMix, MixCustom }) {
         }
     
         async create({ config = {}, options = {} } = {}) {
-            if (!this.config.apiKey) {
-                throw new Error('Gemini API key not found. Please provide it in config or set GEMINI_API_KEY environment variable.');
-            }
-    
             const generateContentApi = options.stream ? 'streamGenerateContent' : 'generateContent';
     
             const fullUrl = `${this.config.url}/${options.model}:${generateContentApi}?key=${this.config.apiKey}`;