✓ Verified ✍️ Content Creation ✓ Enhanced Data

Mm Easy Voice

Simple text-to-speech skill using MiniMax Voice API.

Rating: 4.6 (494 reviews)
Downloads: 32,723 downloads
Version: 1.0.0

Overview

Simple text-to-speech skill using MiniMax Voice API.

Complete Documentation

View Source →

MiniMax Easy Voice

Simple text-to-speech skill powered by MiniMax Voice API. Converts any text into natural-sounding audio with customizable voice selection.

Usage

[Step 1] Preparation

IMPORTANT: Before using this skill, always verify the environment:

bash

python check_environment.py

If API key is not set:

bash

export MINIMAX_VOICE_API_KEY="your-api-key-here"

Requirements:

Python 3.8+
MINIMAX_VOICE_API_KEY environment variable (required)
FFmpeg (optional, for audio merging/conversion)

[Step 2] Generate speech audio from text

Convert any text to speech in one command:

bash

# Default voice (male-qn-qingse)
python mmvoice.py tts "Hello, this is a test." -o test.mp3

# Chinese text
python mmvoice.py tts "你好，这是一个测试。" -o test_cn.mp3

# Specify a different voice by "-v voice_id"
python mmvoice.py tts "Hello world" -v female-shaonv -o hello.mp3

# Specify output path
python mmvoice.py tts "Your text" -o /path/to/output.mp3

Required parameters:

text: The text you want to convert to speech
-o OUTPUT: Output audio file path (required)

Optional parameters:

-v VOICE_ID: Voice to use (default: male-qn-qingse)

Usage Details

Text length limits:

Up to 10,000 characters per request
For longer text, split into multiple requests and merge later

Pause insertion: Use <#x#> where x = pause duration in seconds

Example: "Hello<#1.5#>world" = 1.5 second pause between words
Range: 0.01 to 99.99 seconds

Emotion matching: speech-2.8 models automatically match emotions to your text content

Voice Selection

Choose the right voice for your content by consulting the voice catalog:

bash

# List all available voices
python mmvoice.py list-voices

Voice catalog: reference/voice_catalog.md

Contains:

All available system voices (male, female)
Voice characteristics and recommended use cases
How to select the right voice for your content

Advanced Options

Voice Management

List available voices:

bash

python mmvoice.py list-voices

Clone a voice from audio sample:

bash

python mmvoice.py clone audio_file.mp3 --voice-id my-custom-voice

Design a voice from description:

bash

python mmvoice.py design "A warm, gentle female voice" --voice-id designed-voice

Audio Processing

Merge multiple audio files:

bash

python mmvoice.py merge file1.mp3 file2.mp3 file3.mp3 -o combined.mp3

Convert audio format:

bash

python mmvoice.py convert input.wav -o output.mp3 --format mp3

Reference Documents

Open these when needed for more details:

|| Document | When to Use | ||----------|-------------| || reference/voice_catalog.md | Choosing a voice_id | || reference/getting-started.md | Environment setup | || reference/audio-guide.md | Audio processing | || reference/voice-guide.md | Voice cloning and design | || reference/troubleshooting.md | Common issues and solutions |

Troubleshooting

Common issues:

API key not set: Run export MINIMAX_VOICE_API_KEY="your-key"
FFmpeg missing: Install with brew install ffmpeg (macOS) or sudo apt install ffmpeg (Ubuntu)
Voice not found: Use python mmvoice.py list-voices to see available voices

Run environment check:

bash

python check_environment.py

See reference/troubleshooting.md for more solutions.

Installation

Terminal bash


openclaw install mm-easy-voice

Copied!

💻Code Examples

export MINIMAX_VOICE_API_KEY="your-api-key-here"

export-minimaxvoiceapikeyyour-api-key-here.txt

**Requirements:**
- Python 3.8+
- MINIMAX_VOICE_API_KEY environment variable (required)
- FFmpeg (optional, for audio merging/conversion)


### [Step 2] Generate speech audio from text

Convert any text to speech in one command:

python mmvoice.py tts "Your text" -o /path/to/output.mp3

python-mmvoicepy-tts-your-text--o-pathtooutputmp3.txt

**Required parameters:**
- `text`: The text you want to convert to speech
- `-o OUTPUT`: Output audio file path (required)

**Optional parameters:**
- `-v VOICE_ID`: Voice to use (default: male-qn-qingse)


### Usage Details

**Text length limits:**
- Up to 10,000 characters per request
- For longer text, split into multiple requests and merge later

**Pause insertion:** Use `<#x#>` where x = pause duration in seconds
- Example: `"Hello<#1.5#>world"` = 1.5 second pause between words
- Range: 0.01 to 99.99 seconds

**Emotion matching:** speech-2.8 models automatically match emotions to your text content



## Voice Selection

Choose the right voice for your content by consulting the voice catalog:

python mmvoice.py list-voices

python-mmvoicepy-list-voices.txt

**Voice catalog:** `reference/voice_catalog.md`

Contains:
- All available system voices (male, female)
- Voice characteristics and recommended use cases
- How to select the right voice for your content


## Advanced Options

### Voice Management

**List available voices:**

python mmvoice.py design "A warm, gentle female voice" --voice-id designed-voice

python-mmvoicepy-design-a-warm-gentle-female-voice---voice-id-designed-voice.txt

### Audio Processing

**Merge multiple audio files:**

python mmvoice.py convert input.wav -o output.mp3 --format mp3

python-mmvoicepy-convert-inputwav--o-outputmp3---format-mp3.txt

## Reference Documents

Open these when needed for more details:

|| Document | When to Use |
||----------|-------------|
|| `reference/voice_catalog.md` | Choosing a voice_id |
|| `reference/getting-started.md` | Environment setup |
|| `reference/audio-guide.md` | Audio processing |
|| `reference/voice-guide.md` | Voice cloning and design |
|| `reference/troubleshooting.md` | Common issues and solutions |


## Troubleshooting

Common issues:

1. **API key not set:** Run `export MINIMAX_VOICE_API_KEY="your-key"`
2. **FFmpeg missing:** Install with `brew install ffmpeg` (macOS) or `sudo apt install ffmpeg` (Ubuntu)
3. **Voice not found:** Use `python mmvoice.py list-voices` to see available voices

Run environment check:

example.sh

# Default voice (male-qn-qingse)
python mmvoice.py tts "Hello, this is a test." -o test.mp3

# Chinese text
python mmvoice.py tts "你好，这是一个测试。" -o test_cn.mp3

# Specify a different voice by "-v voice_id"
python mmvoice.py tts "Hello world" -v female-shaonv -o hello.mp3

# Specify output path
python mmvoice.py tts "Your text" -o /path/to/output.mp3