diff --git a/part9-custom-models.md b/part9-custom-models.md index def831a..e0431ca 100644 --- a/part9-custom-models.md +++ b/part9-custom-models.md @@ -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: @@ -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}