Minimax Use

minimax-use

使用 MiniMax 进行网络搜索、图像理解、图片生成和语音合成。

功能一：网络搜索

调用 web_search

使用脚本调用 MCP 服务：

python3 {curDir}/scripts/web_search.py "<搜索查询>"

示例：

# 搜索今日新闻
python3 {curDir}/scripts/web_search.py "今天的热点新闻"

API 参数说明

功能二：图像理解

准备图片

将图片放到可访问路径，例如：

• ~/.openclaw/workspace/images/图片名.jpg
• 或者使用 URL

调用 understand_image

使用脚本调用 MCP 服务：

python3 {curDir}/scripts/understand_image.py <图片路径或URL> "<对图片的提问>"

示例：

# 描述图片内容
python3 {curDir}/scripts/understand_image.py ~/image.jpg "详细描述这张图片的内容"

# 使用 URL
python3 {curDir}/scripts/understand_image.py "https://example.com/image.jpg" "这张图片展示了什么？"

API 参数说明

功能三：图片生成

注意：图片生成消耗较多 token，执行前必须先询问用户是否同意生成。

调用 image

使用脚本调用 MiniMax 图片生成 API：

python3 {curDir}/scripts/image.py "<描述>" [选项]

示例：

# 文生图（T2I）
python3 {curDir}/scripts/image.py "一只可爱的猫咪在阳光下玩耍"

# 指定宽高比和数量
python3 {curDir}/scripts/image.py "一只可爱的猫咪在阳光下玩耍" --aspect-ratio 16:9 --n 2

# 指定宽高
python3 {curDir}/scripts/image.py "一只可爱的猫咪在阳光下玩耍" --width 1024 --height 768 --output cat.png

# 图生图（I2I）
python3 {curDir}/scripts/image.py --subject /path/to/image.jpg "猫咪玩耍"

选项说明

可用模型

文生图（T2I）：

• image-01
• image-01-live

图生图（I2I）：

• image-01
• image-01-live

宽高比选项

• 1:1 (1024x1024)
• 16:9 (1280x720)
• 4:3 (1152x864)
• 3:2 (1248x832)
• 2:3 (832x1248)
• 3:4 (864x1152)
• 9:16 (720x1280)
• 21:9 (1344x576) (仅适用于 image-01)

功能四：语音合成 (Text-to-Speech)

调用 text_to_speech

使用脚本调用 MiniMax 语音合成 API：

python3 {curDir}/scripts/text_to_speech.py "<文本>" [选项]

示例：

# 基础语音合成
python3 {curDir}/scripts/text_to_speech.py "你好世界" --output audio.mp3

# 指定音色和情感
python3 {curDir}/scripts/text_to_speech.py "今天真开心" --voice female-shaonv --emotion happy --output happy.mp3

# 列出所有可用音色
python3 {curDir}/scripts/text_to_speech.py --list-voices

选项说明