MiniMax TTS (Text-to-Speech)#

⚠️ Requires a MiniMax API Key with TTS/Speech access

• Coding Plan key (sk-cp-xxx) → 不支持 TTS，仅限 M2.7 聊天模型
• 通用 API Key → 请在 MiniMax 开放平台 确认您的订阅是否包含语音合成
• TTS 独立套餐: 访问 MiniMax 语音合成产品

Text-to-speech synthesis using MiniMax's speech synthesis API. Supports 40+ languages, multiple voices, adjustable speed/pitch, and various audio formats.

---

Setup#

1. Configure API Key#

bash

openclaw config set skills.entries.minimax-tts.apiKey "sk-your-key"

Or add to openclaw.json skills entries:

json

{
  "skills": {
    "entries": {
      "minimax-tts": {
        "apiKey": "sk-your-key"
      }
    }
  }
}

2. Dependencies#

bash

pip install requests

---

Architecture#

text

~/.openclaw/workspace/skills/minimax-tts/
├── SKILL.md
├── _meta.json
└── scripts/
    └── minimax_tts.py

---

Usage#

From terminal#

bash

# Basic TTS - text to speech
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_tts.py "你好，欢迎使用 MiniMax 语音合成"

# With voice selection
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_tts.py "Hello world" --voice female-shaonv

# Adjust speed and pitch
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_tts.py "快速播报新闻" --speed 1.5 --pitch 2

# Save to file
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_tts.py "输出到文件" --output speech.mp3

# List available voices
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_tts.py --list-voices

# Multi-segment (audiobook/podcast with multiple voices)
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_tts.py --segments segments.json --output combined.mp3

From code#

python

from minimax_tts import generate_speech

# Basic TTS
result = generate_speech(text="你好世界", voice="female-shaonv", output_path="hello.mp3")

# With options
result = generate_speech(
    text="这是一段测试语音",
    model="speech-2.8-hd",
    voice="female-tianmei",
    speed=1.0,
    pitch=0,
    audio_format="mp3",
    output_path="test.mp3"
)

---

Tool Definition#

Name: minimax_tts

Input Schema:

json

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Text to convert to speech (max 10000 chars per request)"
    },
    "model": {
      "type": "string",
      "enum": ["speech-2.8-hd", "speech-2.6-hd", "speech-02-hd"],
      "default": "speech-2.8-hd",
      "description": "TTS model: speech-2.8-hd (recommended, high quality with emotion control), speech-2.6-hd (Coding Plan NOT supported), speech-02-hd (compact HD voice)"
    },
    "voice": {
      "type": "string",
      "default": "female-tianmei",
      "description": "Voice ID: female-tianmei, female-shaonv, female-yujie, female-chengshu, male-qn-qingse, male-qn-jingying, male-qn-badao, male-qn-daxuesheng"
    },
    "speed": {
      "type": "number",
      "default": 1.0,
      "minimum": 0.5,
      "maximum": 2.0,
      "description": "Speech speed, range 0.5-2.0, default 1.0"
    },
    "pitch": {
      "type": "number",
      "default": 0,
      "minimum": -12,
      "maximum": 12,
      "description": "Voice pitch adjustment, range -12 to 12, default 0"
    },
    "audio_format": {
      "type": "string",
      "enum": ["mp3", "wav", "pcm"],
      "default": "mp3",
      "description": "Output audio format"
    },
    "output_path": {
      "type": "string",
      "description": "Save audio to this file path. Default: saved to ~/.openclaw/workspace/tmp/tts_<timestamp>.mp3"
    }
  },
  "required": ["text"]
}

Output: JSON with success status and audio file path

---

Common Voice IDs#

voice_idDescriptionGenderfemale-tianmei甜美女声Femalefemale-shaonv少女音Femalefemale-yujie御姐音色Femalefemale-chengshu成熟女性Femalemale-qn-qingse青年男声（青涩）Malemale-qn-jingying青年男声（精英）Malemale-qn-badao青年男声（霸道）Malemale-qn-daxuesheng青年大学生Male

---

Multi-Segment Generation (Audiobooks / Podcasts)#

For multi-character content, create a segments.json file and use --segments:

bash

python3 scripts/minimax_tts.py --segments segments.json --output combined.mp3

segments.json Format#

json

[
  {
    "text": "Morning sunlight streamed into the room.",
    "voice": "female-tianmei",
    "speed": 1.0
  },
  {
    "text": "Welcome to today's episode.",
    "voice": "male-qn-qingse",
    "speed": 1.0
  }
]

---

Error Codes#

CodeMeaning0Success1002Rate limit - try again later1004Auth failed - check API Key1008Insufficient balance1026Content violation2013Parameter error2049Invalid API Key