Skip to content

docs: add MiniMax M3 models and regional endpoints #28

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
octo-patch wants to merge 3 commits into
base: main
Choose a base branch
from
Open

docs: add MiniMax M3 models and regional endpoints #28

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
987deb3
docs: add MiniMax M3 model and endpoint reference
octo-patch Jul 10, 2026
2b9c8c7
docs: correct MiniMax Anthropic base URLs
octo-patch Jul 12, 2026
d94127f
docs: complete MiniMax pricing and endpoint config
octo-patch Jul 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 51 additions & 0 deletions part9-custom-models.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -138,6 +138,54 @@ hermes model

Hermes probes the endpoint, detects OpenAI-style `/chat/completions` vs Anthropic-style `/messages`, discovers deployments when possible, and stores the right `api_mode` in `config.yaml`.

### MiniMax M3 Models and Regional Endpoints

Hermes registers `minimax` for the global API and `minimax-cn` for the mainland China API. Both providers support `MiniMax-M3` and `MiniMax-M2.7`. Add aliases when you want to pin either model without changing your default:

```yaml
model_aliases:
minimax-m3:
provider: minimax
model: MiniMax-M3
minimax-m2.7:
provider: minimax
model: MiniMax-M2.7
```

Model metadata (July 8, 2026):

| Model | Total context | Input | Thinking |
|-------|--------------:|-------|----------|
| `MiniMax-M3` | 1,000,000 | text, image, video | adaptive or disabled |
| `MiniMax-M2.7` | 204,800 | text | always on |

Pay-as-you-go pricing in USD per million tokens (July 8, 2026):

| Model | Service tier | Input-token band | Input | Output | Cache read | Cache write |
|-------|--------------|------------------|------:|-------:|-----------:|------------:|
| `MiniMax-M3` | standard | <= 512,000 | $0.30 | $1.20 | $0.06 | - |
| `MiniMax-M3` | standard | > 512,000 | $0.60 | $2.40 | $0.12 | - |
| `MiniMax-M3` | priority | <= 512,000 | $0.45 | $1.80 | $0.09 | - |
| `MiniMax-M3` | priority | > 512,000 | $0.90 | $3.60 | $0.18 | - |
| `MiniMax-M2.7` | - | all | $0.30 | $1.20 | $0.06 | $0.375 |

Choose the API region and protocol together. Set `provider`, `base_url`, and `api_mode` under `model` from one complete row below; `default` can be either model ID. The Anthropic SDK appends `/v1/messages` to the `/anthropic` base URL, while the OpenAI SDK appends `/chat/completions` to the `/v1` base URL.

```yaml
model:
provider: minimax
default: MiniMax-M3
base_url: https://api.minimax.io/anthropic
api_mode: anthropic_messages
```

| Region | Protocol | `provider` | `base_url` | `api_mode` | Documentation |
|--------|----------|------------|------------|------------|---------------|
| Global | OpenAI-compatible | `minimax` | `https://api.minimax.io/v1` | `chat_completions` | `https://platform.minimax.io/docs` |
| Global | Anthropic-compatible | `minimax` | `https://api.minimax.io/anthropic` | `anthropic_messages` | `https://platform.minimax.io/docs` |
| Mainland China | OpenAI-compatible | `minimax-cn` | `https://api.minimaxi.com/v1` | `chat_completions` | `https://platform.minimaxi.com/docs` |
| Mainland China | Anthropic-compatible | `minimax-cn` | `https://api.minimaxi.com/anthropic` | `anthropic_messages` | `https://platform.minimaxi.com/docs` |

### Remote Model Catalog: Stop Hardcoding This Week's Winner

OpenRouter and Nous Portal model pickers now fetch:
Expand Down Expand Up @@ -217,6 +265,9 @@ providers:
minimax:
api_key: ${MINIMAX_API_KEY}

minimax-cn:
api_key: ${MINIMAX_CN_API_KEY}

gmi:
api_key: ${GMI_API_KEY}

Expand Down