modelmix 5.1.9 → 5.1.12

package/lib/providers/openai-compatible.js

@@ -2,14 +2,12 @@ const {
     GROK420_REASONING,
     GROK420_NON_REASONING
 } = require('../../effort');
+const { requireProviderApiKey } = require('../provider-api-key');
 
 function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     class MixMiniMax extends MixOpenAI {
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'MINIMAX_API_KEY', 'MiniMax');
     
             return MixCustom.prototype.getDefaultConfig.call(this, {
                 url: 'https://api.minimax.io/v1/chat/completions',
@@ -29,10 +27,7 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixMiMo extends MixOpenAI {
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'MIMO_API_KEY', 'MiMo');
     
             return MixCustom.prototype.getDefaultConfig.call(this, {
                 url: 'https://api.xiaomimimo.com/v1/chat/completions',
@@ -53,10 +48,7 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixPerplexity extends MixCustom {
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'PPLX_API_KEY', 'Perplexity');
     
             return super.getDefaultConfig({
                 url: 'https://api.perplexity.ai/chat/completions',
@@ -133,10 +125,7 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixGrok extends MixOpenAI {
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'XAI_API_KEY', 'Grok');
     
             return super.getDefaultConfig({
                 url: 'https://api.x.ai/v1/chat/completions',
@@ -155,10 +144,7 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixLambda extends MixCustom {
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'LAMBDA_API_KEY', 'Lambda');
     
             return super.getDefaultConfig({
                 url: 'https://api.lambda.ai/v1/chat/completions',
@@ -235,10 +221,7 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixGroq extends MixCustom {
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'GROQ_API_KEY', 'Groq');
     
             return super.getDefaultConfig({
                 url: 'https://api.groq.com/openai/v1/chat/completions',
@@ -250,10 +233,7 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixTogether extends MixCustom {
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'TOGETHER_API_KEY', 'Together');
     
             return super.getDefaultConfig({
                 url: 'https://api.together.xyz/v1/chat/completions',
@@ -272,10 +252,7 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixCerebras extends MixCustom {
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'CEREBRAS_API_KEY', 'Cerebras');
     
             return super.getDefaultConfig({
                 url: 'https://api.cerebras.ai/v1/chat/completions',
@@ -292,10 +269,7 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixFireworks extends MixCustom {
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'FIREWORKS_API_KEY', 'Fireworks');
     
             return super.getDefaultConfig({
                 url: 'https://api.fireworks.ai/inference/v1/chat/completions',
@@ -307,10 +281,7 @@ function createCompatibleProviders({ MixCustom, MixOpenAI }) {
     
     class MixNVIDIA extends MixCustom {
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'NVIDIA_API_KEY', 'NVIDIA');
     
             return super.getDefaultConfig({
                 url: 'https://integrate.api.nvidia.com/v1/chat/completions',

package/lib/providers/openai-options.js

@@ -0,0 +1,16 @@
+function normalizeOpenAIOptions(options) {
+    if (/^o\d/.test(options.model || '')) {
+        delete options.max_tokens;
+        delete options.temperature;
+    }
+    if (options.model?.includes('gpt-5')) {
+        if (options.max_tokens) {
+            options.max_completion_tokens = options.max_tokens;
+            delete options.max_tokens;
+        }
+        delete options.temperature;
+    }
+    return options;
+}
+
+module.exports = { normalizeOpenAIOptions };

package/lib/providers/openai.js

@@ -4,31 +4,21 @@ const {
     normalizeContentCache,
     stripContentCacheMetadata
 } = require('../content-cache');
+const { requireProviderApiKey } = require('../provider-api-key');
+const { normalizeOpenAIOptions } = require('./openai-options');
 
 function createOpenAIProviders({
     ModelMix,
     MixCustom,
     MixOpenAI,
-    MixModeration
+    MixModeration,
+    rejectsAnthropicSamplingParams
 }) {
     const WebSocket = require('ws');
 
     class MixOpenAIResponses extends MixOpenAI {
         async create({ config = {}, options = {} } = {}) {
-    
-            // Keep GPT/o-model option normalization behavior
-            if (options.model?.startsWith('o')) {
-                delete options.max_tokens;
-                delete options.temperature;
-            }
-            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);
             const responsesUrl = this.config.url.replace('/chat/completions', '/responses');
             const request = MixOpenAIResponses.buildResponsesRequest(options, config);
             const response = await fetchJsonResponse(responsesUrl, {
@@ -246,10 +236,7 @@ function createOpenAIProviders({
     
     class MixOpenAIModeration extends MixModeration {
         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/moderations',
@@ -357,18 +344,7 @@ function createOpenAIProviders({
         }
     
         async create({ config = {}, options = {} } = {}) {
-            if (options.model?.startsWith('o')) {
-                delete options.max_tokens;
-                delete options.temperature;
-            }
-            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);
             const mergedConfig = { ...this.config, ...config };
             const realtimeUrl = `${mergedConfig.realtimeUrl}?model=${encodeURIComponent(options.model)}`;
             const timeoutMs = mergedConfig.websocketTimeoutMs || 120000;
@@ -556,10 +532,7 @@ function createOpenAIProviders({
     
     class MixOpenRouter extends MixOpenAI {
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'OPENROUTER_API_KEY', 'OpenRouter');
     
             return MixCustom.prototype.getDefaultConfig.call(this, {
                 url: 'https://openrouter.ai/api/v1/chat/completions',
@@ -567,14 +540,20 @@ function createOpenAIProviders({
                 ...customConfig
             });
         }
+
+        async create({ config = {}, options = {} } = {}) {
+            if (rejectsAnthropicSamplingParams(options.model)) {
+                delete options.temperature;
+                delete options.top_p;
+                delete options.top_k;
+            }
+            return super.create({ config, options });
+        }
     }
     
     class MixKimi extends MixOpenAI {
         getDefaultConfig(customConfig) {
-            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.');
-            }
+            const apiKey = requireProviderApiKey(customConfig, 'MOONSHOT_API_KEY', 'Moonshot');
     
             return MixCustom.prototype.getDefaultConfig.call(this, {
                 url: 'https://api.moonshot.ai/v1/chat/completions',

package/lib/providers.js

@@ -1,12 +1,15 @@
 const createBaseProviders = require('./providers/base');
 const createOpenAIProviders = require('./providers/openai');
-const createAnthropicProviders = require('./providers/anthropic');
+const {
+    createAnthropicProviders,
+    rejectsAnthropicSamplingParams
+} = require('./providers/anthropic');
 const createCompatibleProviders = require('./providers/openai-compatible');
 const createGoogleProviders = require('./providers/google');
 
 function createProviders({ ModelMix, log }) {
     const base = createBaseProviders({ ModelMix });
-    const openai = createOpenAIProviders({ ModelMix, ...base });
+    const openai = createOpenAIProviders({ ModelMix, rejectsAnthropicSamplingParams, ...base });
     const anthropic = createAnthropicProviders({ ModelMix, MixCustom: base.MixCustom, log });
     const compatible = createCompatibleProviders({
         MixCustom: base.MixCustom,

package/lib/token-usage.js

@@ -35,6 +35,8 @@ const MODEL_PRICING = {
     'gpt-5.3-codex': { input: 1.75, cachedInput: 0.175, output: 14.00 },
     'gpt-5.2': { input: 1.75, cachedInput: 0.175, output: 14.00 },
     'gpt-5.2-chat-latest': { input: 1.75, cachedInput: 0.175, output: 14.00 },
+    'gpt-5.3-chat-latest': { input: 1.75, cachedInput: 0.175, output: 14.00 },
+    'openai/gpt-5.3-chat': { input: 1.75, cachedInput: 0.175, output: 14.00 },
     'gpt-5.1': { input: 1.25, cachedInput: 0.125, output: 10.00 },
     'gpt-5': { input: 1.25, cachedInput: 0.125, output: 10.00 },
     'gpt-5-mini': { input: 0.25, cachedInput: 0.025, output: 2.00 },
@@ -47,6 +49,8 @@ const MODEL_PRICING = {
     'gpt-oss-120b': { input: 0.15, output: 0.60 },
     'accounts/fireworks/models/gpt-oss-120b': { input: 0.15, cachedInput: 0.014, output: 0.60 },
     // Anthropic
+    'claude-fable-5-1': { input: 10.00, cachedInput: 0.25, cacheWrite: 12.50, cacheWrite1h: 20.00, output: 50.00 },
+    'anthropic/claude-fable-5.1': { input: 10.00, cachedInput: 0.25, cacheWrite: 12.50, cacheWrite1h: 20.00, output: 50.00 },
     'claude-fable-5': { input: 10.00, cachedInput: 1.00, cacheWrite: 12.50, cacheWrite1h: 20.00, output: 50.00 },
     'claude-opus-5': { input: 5.00, cachedInput: 0.50, cacheWrite: 6.25, cacheWrite1h: 10.00, output: 25.00 },
     'claude-sonnet-5': { input: 3.00, cachedInput: 0.30, cacheWrite: 3.75, cacheWrite1h: 6.00, output: 15.00 },
@@ -75,10 +79,11 @@ const MODEL_PRICING = {
     'grok-4.20-0309': { input: 1.25, output: 2.50 },
     'grok-4.20-0309-reasoning': { input: 1.25, output: 2.50 },
     'grok-4.20-0309-non-reasoning': { input: 1.25, output: 2.50 },
-    // Muse Glimmer 30B (NVIDIA/OpenRouter, Fireworks, Together)
+    // Muse
     'meta/muse-glimmer-30b': { input: 0.35, cachedInput: 0.04, output: 1.50 },
     'accounts/fireworks/models/muse-glimmer-30b': { input: 0.35, cachedInput: 0.04, output: 1.50 },
     'meta-models/Muse-Glimmer-30B': { input: 0.35, cachedInput: 0.04, output: 1.50 },
+    'meta/muse-spark-1.2-contributor': { input: 0.10, cachedInput: 0.002, output: 0.20 },
     // Fireworks
     'accounts/fireworks/models/deepseek-v4-flash': { input: 0.14, output: 0.28 },
     'accounts/fireworks/models/deepseek-v4-pro': { input: 1.74, output: 3.48 },
@@ -200,7 +205,7 @@ function normalizeTokenUsage({ input = 0, output = 0, thinking = 0, total, cache
 }
 
 function calculateCostBreakdown(modelKey, tokens) {
-    const pricing = MODEL_PRICING[modelKey];
+    const pricing = getModelPricing(modelKey);
     if (!pricing) return normalizeTokenUsage().costBreakdown;
 
     const normalized = normalizeTokenUsage(tokens);
@@ -249,7 +254,7 @@ function calculateCostBreakdown(modelKey, tokens) {
 }
 
 function calculateCacheMetrics(modelKey, tokens) {
-    const pricing = MODEL_PRICING[modelKey];
+    const pricing = getModelPricing(modelKey);
     const emptyMetrics = {
         cacheSavings: 0,
         cacheWritePremium: 0,
@@ -296,7 +301,17 @@ function calculateCost(modelKey, tokens) {
 }
 
 function hasModelPricing(modelKey) {
-    return Object.prototype.hasOwnProperty.call(MODEL_PRICING, modelKey);
+    return getModelPricing(modelKey) !== undefined;
+}
+
+function getModelPricing(modelKey) {
+    if (Object.prototype.hasOwnProperty.call(MODEL_PRICING, modelKey)) {
+        return MODEL_PRICING[modelKey];
+    }
+    if (typeof modelKey === 'string' && modelKey.startsWith('openai/')) {
+        return MODEL_PRICING[modelKey.slice('openai/'.length)];
+    }
+    return undefined;
 }
 
 function extractCacheTokens(usage = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modelmix",
-  "version": "5.1.9",
+  "version": "5.1.12",
   "description": "🧬 Reliable interface with automatic fallback for AI LLMs.",
   "main": "index.js",
   "types": "index.d.ts",
@@ -27,6 +27,7 @@
     "gpt5",
     "opus50",
     "opus5",
+    "fable51",
     "fable50",
     "fable",
     "sonnet",

package/plugins/rlm/lib/budget.js

@@ -1,3 +1,5 @@
+const { positiveInteger } = require('./validation');
+
 class RlmLimitError extends Error {
     constructor(limit, message) {
         super(message);
@@ -6,13 +8,6 @@ class RlmLimitError extends Error {
     }
 }
 
-function positiveInteger(value, name) {
-    if (!Number.isInteger(value) || value <= 0) {
-        throw new TypeError(`${name} must be a positive integer.`);
-    }
-    return value;
-}
-
 function validateRuntimeLimits(limits) {
     if (!limits || typeof limits !== 'object' || Array.isArray(limits)) {
         throw new TypeError('limits must be a plain object.');

package/plugins/rlm/lib/planner-prompt.js

@@ -1,15 +1,9 @@
 const path = require('path');
 const { describeVariables } = require('./variable-descriptors');
+const { positiveInteger } = require('./validation');
 
 const PLANNER_SYSTEM_TEMPLATE = path.resolve(__dirname, '../prompts/planner.md');
 
-function positiveInteger(value, name) {
-    if (!Number.isInteger(value) || value <= 0) {
-        throw new TypeError(`${name} must be a positive integer.`);
-    }
-    return value;
-}
-
 function planningHint(name, descriptor, maxQueryBytes) {
     const payloadBytes = descriptor.utf8Bytes ?? descriptor.estimatedBytes;
     if (payloadBytes <= maxQueryBytes) {

package/plugins/rlm/lib/plugin.js

@@ -9,12 +9,7 @@ const {
     sumTokens
 } = require('./runtime');
 const { createWorkerCatalog } = require('./worker-catalog');
-
-function isPlainObject(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) return false;
-    const prototype = Object.getPrototypeOf(value);
-    return prototype === Object.prototype || prototype === null;
-}
+const { isPlainObject } = require('./validation');
 
 function validateSandbox(sandbox) {
     if (!sandbox || typeof sandbox !== 'object' || typeof sandbox.execute !== 'function') {

package/plugins/rlm/lib/validation.js

@@ -0,0 +1,14 @@
+function isPlainObject(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+
+function positiveInteger(value, name) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new TypeError(`${name} must be a positive integer.`);
+    }
+    return value;
+}
+
+module.exports = { isPlainObject, positiveInteger };

package/plugins/rlm/lib/variable-descriptors.js

@@ -1,8 +1,4 @@
-function isPlainObject(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) return false;
-    const prototype = Object.getPrototypeOf(value);
-    return prototype === Object.prototype || prototype === null;
-}
+const { isPlainObject } = require('./validation');
 
 function roundAverage(total, count) {
     return count === 0 ? 0 : Number((total / count).toFixed(2));

package/plugins/rlm/lib/worker-catalog.js

@@ -1,8 +1,4 @@
-function isPlainObject(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) return false;
-    const prototype = Object.getPrototypeOf(value);
-    return prototype === Object.prototype || prototype === null;
-}
+const { isPlainObject } = require('./validation');
 
 function finiteRating(value, path) {
     if (!Number.isFinite(value) || value < 0) {

package/pnpm-workspace.yaml

@@ -6,11 +6,16 @@ allowBuilds:
 
 minimumReleaseAgeExclude:
   - ws@8.21.0
-  - hono@4.12.25
-  - js-yaml@4.1.2
-  - brace-expansion@5.0.8
+  - fast-uri@3.1.5
+  - hono@4.12.34
+  - ip-address@10.3.1
+  - js-yaml@4.3.1
+  - brace-expansion@5.0.9
 overrides:
-  brace-expansion@<=5.0.7: ^5.0.8
+  brace-expansion: 5.0.9
   diff: 8.0.4
-  ip-address: 10.2.0
+  fast-uri: 3.1.5
+  hono: 4.12.34
+  ip-address: 10.3.1
+  js-yaml: 4.3.1
   serialize-javascript: 7.0.5

package/schema.js

@@ -122,31 +122,3 @@ function generateJsonSchema(example, descriptions = {}) {
 }
 
 module.exports = generateJsonSchema;
-
-// const example = {
-//     name: 'Alice',
-//     age: 30,
-//     email: 'alice@example.com',
-//     birthDate: '1990-01-01',
-//     isAdmin: false,
-//     preferences: {
-//         theme: 'dark',
-//         notifications: true
-//     },
-//     tags: ['admin', 'user']
-// };
-
-// const descriptions = {
-//     name: 'Full name of the user',
-//     age: 'Age must be 0 or greater',
-//     email: 'User email address',
-//     // birthDate: 'User birth date in YYYY-MM-DD format',
-//     preferences: {
-//         theme: 'Theme preference (light/dark)',
-//         notifications: 'Whether notifications are enabled'
-//     }
-// };
-
-// const schema = generateJsonSchema(example);
-
-// console.log(JSON.stringify(schema, null, 2));

package/skills/modelmix/SKILL.md

@@ -151,13 +151,17 @@ ModelMix.new({ config: { effort: 80 } })
 
 Use `ModerationMix.new().openai()` with `.raw()` to classify text and images through OpenAI's Moderations endpoint. Read the results from `raw.moderation`. `ModerationMix` accepts moderation providers as ordered fallbacks, rejects generative providers, and does not generate text or support streaming.
 
-`gpt52()` `gpt52chat()` `gpt51()` `gpt5()` `gpt5mini()` `gpt5nano()` `gpt45()` `o3()` `o4mini()`
+`gpt56sol()` `gpt56terra()` `gpt56luna()` `gpt55()` `gpt55pro()` `gpt54()` `gpt54mini()` `gpt54nano()` `gpt54pro()` `gpt53codex()` `gpt53chat()` `gpt52()` `gpt51()` `gpt5()` `gpt5mini()` `gpt5nano()` `gptRealtime()` `gptRealtimeMini()` `gptOss()`
+
+Every textual GPT-5 shortcut registers only the official OpenAI model by default. Pass `mix: { openrouter: true }` to `ModelMix.new()` or to an individual shortcut to append its `openai/*` OpenRouter route as a fallback. `gpt53chat()` uses `gpt-5.3-chat-latest` officially and `openai/gpt-5.3-chat` through OpenRouter. Both API keys are required when that fallback is enabled. Realtime shortcuts remain official-only.
 
 ### Anthropic
-`fable50()` `opus50()` `opus48()` `opus47()` `opus46()` `sonnet5()` `sonnet46()` `sonnet45()` `haiku45()`
+`fable51()` `fable50()` `opus50()` `opus48()` `opus47()` `opus46()` `sonnet5()` `sonnet46()` `sonnet45()` `haiku45()`
 
 Use `.effort(n)` (or `config.effort`) to enable Anthropic thinking — e.g. `.effort(100).opus50()`. `fable5()` and `opus5()` remain available as compatibility aliases.
 
+`fable51()` registers `claude-fable-5-1` through Anthropic by default. Pass `mix: { openrouter: true }` to append `anthropic/claude-fable-5.1` as its fallback.
+
 ### Google
 `gemini31pro()` `gemini37flash()` `gemini36flash()` `gemini35flash()` `gemini35flashLite()` `gemini31flashLite()`
 
@@ -186,7 +190,7 @@ Use `.effort(n)` (or `config.effort`) to enable Anthropic thinking — e.g. `.ef
 `GLM46()`
 
 ### OpenRouter
-`museGlimmer30b()` `gptOss()` `qwen35397b()` `qwen36plus()` `qwen37plus()` `qwen3827b()` `qwen38flash()` `hermes470b()` `hermes4405b()` `qwen38max()` `kimiK27Code()` `kimiK3()` `minimaxM27()` `minimaxM3()` `GLM45()` `GLM52()` `GLM53()` `GLM53Flash()`
+`museGlimmer30b()` `museSpark12Contributor()` `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()`
@@ -551,10 +555,9 @@ For full debug output, also set: `DEBUG=ModelMix* node script.js`
 ### Free-tier models
 
 ```javascript
-const model = ModelMix.new({ mix: { openrouter: false } })
+const model = ModelMix.new()
     .gptOss()
     .kimiK25()
-    .hermes3()
     .addText("What is the capital of France?");
 console.log(await model.message());
 ```
@@ -568,7 +571,8 @@ Some model shorthands register the same model across multiple providers for maxi
 ```javascript
 const model = ModelMix.new({
     mix: {
-        openrouter: true,   // default: true
+        anthropic: true,    // fable51() default: true
+        openrouter: false,  // fallback default: false
         cerebras: true,      // default: true
         groq: true,          // default: true
         together: false,     // default: false

package/test/anthropic.test.js

@@ -1,8 +1,84 @@
 const { expect } = require('chai');
 const nock = require('nock');
-const { ModelMix, MixAnthropic } = require('../index.js');
+const { ModelMix, MixAnthropic, MixOpenRouter } = require('../index.js');
 
 describe('Anthropic Model Registration Tests', () => {
+    it('should register Claude Fable 5.1 through Anthropic by default', () => {
+        const model = ModelMix.new().fable51();
+
+        expect(model.models.map(({ key }) => key)).to.deep.equal(['claude-fable-5-1']);
+        expect(model.models[0].provider).to.be.instanceOf(MixAnthropic);
+    });
+
+    it('should allow enabling or selecting the OpenRouter Claude Fable 5.1 route', () => {
+        const both = ModelMix.new().fable51({ mix: { openrouter: true } });
+        const routed = ModelMix.new().fable51({
+            mix: { anthropic: false, openrouter: true }
+        });
+
+        expect(both.models.map(({ key }) => key)).to.deep.equal([
+            'claude-fable-5-1',
+            'anthropic/claude-fable-5.1'
+        ]);
+        expect(both.models[1].provider).to.be.instanceOf(MixOpenRouter);
+        expect(routed.models.map(({ key }) => key)).to.deep.equal(['anthropic/claude-fable-5.1']);
+        expect(routed.models[0].provider).to.be.instanceOf(MixOpenRouter);
+    });
+
+    it('should strip unsupported sampling params from OpenRouter Claude Fable 5.1 requests', async () => {
+        const provider = new MixOpenRouter();
+        let requestBody;
+        nock('https://openrouter.ai')
+            .post('/api/v1/chat/completions', body => {
+                requestBody = body;
+                return true;
+            })
+            .reply(200, {
+                choices: [{ message: { content: 'Done' } }],
+                usage: { prompt_tokens: 1, completion_tokens: 1 }
+            });
+
+        await provider.create({
+            config: { system: 'You are an assistant.' },
+            options: {
+                model: 'anthropic/claude-fable-5.1',
+                messages: [{ role: 'user', content: 'Hello' }],
+                max_tokens: 100,
+                temperature: 1,
+                top_p: 0.9,
+                top_k: 40
+            }
+        });
+
+        expect(requestBody).to.not.have.property('temperature');
+        expect(requestBody).to.not.have.property('top_p');
+        expect(requestBody).to.not.have.property('top_k');
+        expect(requestBody.model).to.equal('anthropic/claude-fable-5.1');
+    });
+
+    it('should price Claude Fable 5.1 cache usage equally across providers', () => {
+        const tokens = {
+            input: 3_000_000,
+            uncachedInput: 1_000_000,
+            cached: 1_000_000,
+            cacheWrite: 1_000_000,
+            cacheWrite5m: 1_000_000,
+            output: 1_000_000
+        };
+        const expected = {
+            uncachedInput: 10,
+            cachedInput: 0.25,
+            cacheWrite: 12.5,
+            cacheWrite5m: 12.5,
+            cacheWrite1h: 0,
+            output: 50,
+            total: 72.75
+        };
+
+        expect(ModelMix.calculateCostBreakdown('claude-fable-5-1', tokens)).to.deep.equal(expected);
+        expect(ModelMix.calculateCostBreakdown('anthropic/claude-fable-5.1', tokens)).to.deep.equal(expected);
+    });
+
     it('should register Claude Fable 5', () => {
         const model = ModelMix.new();
         model.fable50();

package/test/bottleneck.test.js

@@ -247,7 +247,7 @@ describe('Rate Limiting with Bottleneck Tests', () => {
         });
 
         it('should handle rate limiting with API errors', async () => {
-            model.gpt51();
+            model.gpt51({ mix: { openrouter: false } });
             
             nock('https://api.openai.com')
                 .post('/v1/responses')
@@ -455,4 +455,4 @@ describe('Rate Limiting with Bottleneck Tests', () => {
             model.addText('Event test').message();
         });
     });
-});
+});