From 8111e18dbd6c96e80006a80e94ee6287d056c0c1 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Tue, 13 Jan 2026 07:15:18 +0000
Subject: [PATCH] docs: add Opus/MiniMax fallback examples

---
 docs/gateway/configuration.md | 21 +++++++++++++++++++++
 docs/providers/minimax.md     | 22 ++++++++++++++++++++++
 2 files changed, 43 insertions(+)

diff --git a/docs/gateway/configuration.md b/docs/gateway/configuration.md
index 87938edb6..ea951ec9f 100644
--- a/docs/gateway/configuration.md
+++ b/docs/gateway/configuration.md
@@ -1213,6 +1213,27 @@ is already present in `agents.defaults.models`:
 
 If you configure the same alias name (case-insensitive) yourself, your value wins (defaults never override).
 
+Example: Opus 4.5 primary with MiniMax M2.1 fallback (hosted MiniMax):
+
+```json5
+{
+  agents: {
+    defaults: {
+      models: {
+        "anthropic/claude-opus-4-5": { alias: "opus" },
+        "minimax/MiniMax-M2.1": { alias: "minimax" }
+      },
+      model: {
+        primary: "anthropic/claude-opus-4-5",
+        fallbacks: ["minimax/MiniMax-M2.1"]
+      }
+    }
+  }
+}
+```
+
+MiniMax auth: set `MINIMAX_API_KEY` (env) or configure `models.providers.minimax`.
+
 #### `agents.defaults.cliBackends` (CLI fallback)
 
 Optional CLI backends for text-only fallback runs (no tool calls). These are useful as a
diff --git a/docs/providers/minimax.md b/docs/providers/minimax.md
index eab8cb988..ae6f0efdb 100644
--- a/docs/providers/minimax.md
+++ b/docs/providers/minimax.md
@@ -72,6 +72,28 @@ Configure via CLI:
 }
 ```
 
+### MiniMax M2.1 as fallback (Opus primary)
+
+**Best for:** keep Opus 4.5 as primary, fail over to MiniMax M2.1.
+
+```json5
+{
+  env: { MINIMAX_API_KEY: "sk-..." },
+  agents: {
+    defaults: {
+      models: {
+        "anthropic/claude-opus-4-5": { alias: "opus" },
+        "minimax/MiniMax-M2.1": { alias: "minimax" }
+      },
+      model: {
+        primary: "anthropic/claude-opus-4-5",
+        fallbacks: ["minimax/MiniMax-M2.1"]
+      }
+    }
+  }
+}
+```
+
 ### Optional: Local via LM Studio (manual)
 
 **Best for:** local inference with LM Studio.