> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax

> MiniMax model configuration (Text / Image Understanding / Image Generation / Text-to-Speech)

MiniMax supports text chat, image understanding, image generation, and text-to-speech. A single `minimax_api_key` enables all capabilities.

<Tip>
  All capabilities below can be configured in one place via the "Model Management" page in the Web Console, with no need to manually edit the configuration file.
</Tip>

## Text Chat

```json theme={null}
{
  "model": "MiniMax-M3",
  "minimax_api_key": "YOUR_API_KEY"
}
```

| Parameter         | Description                                                                                                    |
| ----------------- | -------------------------------------------------------------------------------------------------------------- |
| `model`           | Can be `MiniMax-M3`, `MiniMax-M2.7`, `MiniMax-M2.7-highspeed`, etc.                                            |
| `minimax_api_key` | Create one in the [MiniMax Console](https://platform.minimaxi.com/user-center/basic-information/interface-key) |

## Image Understanding

MiniMax's M2.x chat models do not support vision natively; vision calls are uniformly routed to `MiniMax-Text-01`. Once `minimax_api_key` is configured, the Agent's Vision tool automatically uses this model, with no need to specify it explicitly in the configuration file.

## Image Generation

```json theme={null}
{
  "skills": {
    "image-generation": {
      "model": "image-01"
    }
  }
}
```

Available models: `image-01`.

## Text-to-Speech (TTS)

```json theme={null}
{
  "text_to_voice": "minimax",
  "text_to_voice_model": "speech-2.8-hd",
  "tts_voice_id": "female-shaonv"
}
```

| Parameter             | Description                                                                                                                |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `text_to_voice_model` | `speech-2.8-hd` (emotional rendering, natural sound), `speech-2.8-turbo` (ultra-fast), `speech-2.6-hd`, `speech-2.6-turbo` |
| `tts_voice_id`        | Voice ID; supports Chinese / Cantonese / English / Japanese / Korean — 70+ voices in total                                 |

Common voice examples:

| Voice ID                | Description                     |
| ----------------------- | ------------------------------- |
| `female-shaonv`         | Chinese · Young Girl (Female)   |
| `female-yujie`          | Chinese · Mature Lady (Female)  |
| `female-tianmei`        | Chinese · Sweet Female (Female) |
| `male-qn-jingying`      | Chinese · Elite Youth (Male)    |
| `male-qn-badao`         | Chinese · Dominant Youth (Male) |
| `Cantonese_GentleLady`  | Cantonese · Gentle Female Voice |
| `English_Graceful_Lady` | English · Graceful Lady         |

For the full voice list (70+ voices across Chinese / Cantonese / English / Japanese / Korean), see the [system voice list](https://platform.minimaxi.com/docs/faq/system-voice-id), or select visually in the Web Console under "Model Management → Text-to-Speech".
