### [多模态生成API服务](https://s.ddm.chat/link/711)

**Published:** 2026-07-23T02:00:22

**Author:** 颠倒梦

**Excerpt:** MiniMax提供的多模态生成API服务，支持文本转语音、语音克隆、视频生成、图像生成等功能，适用于内容创作、…

[

](https://www.minimax.io)  
[

](https://arxiv.org/abs/2501.08313)  
[

](https://chat.minimax.io/)  
[

](https://www.minimax.io/platform)

[

](https://huggingface.co/MiniMaxAI)  
[

](https://github.com/MiniMax-AI/MiniMax-AI.github.io/blob/main/images/wechat-qrcode.jpeg)  
[

](https://www.modelscope.cn/organization/MiniMax)

[

](https://github.com/MiniMax-AI/MiniMax-MCP/blob/main/LICENSE)

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech and video/image generation APIs. This server allows MCP clients like [Claude Desktop](https://www.anthropic.com/claude), [Cursor](https://www.cursor.so), [Windsurf](https://codeium.com/windsurf), [OpenAI Agents](https://github.com/openai/openai-agents-python) and others to generate speech, clone voices, generate video, generate image and more.

## 文档

-   [中文文档](README-CN.md)
-   [MiniMax MCP JS](https://github.com/MiniMax-AI/MiniMax-MCP-JS) -MiniMax MCP的官方JavaScript实现

## MCP客户端快速入门

1.  从获取API密钥 [极大极小](https://www.minimax.io/platform/user-center/basic-information/interface-key).
2.  安装 `uv` （Python包管理器），安装 `curl -LsSf https://astral.sh/uv/install.sh | sh` 或查看 `uv` [仓库](https://github.com/astral-sh/uv) 有关其他安装方法。
3.  **重要**：API主机和密钥因地区而异，必须匹配；否则，你会遇到 `Invalid API key` 错误。

| 地区  | 全球  | 大陆  |
| :--- | :--- | :--- |
| MINIMAX\_API\_KEY | 从获取 [MiniMax全球](https://www.minimax.io/platform/user-center/basic-information/interface-key) | 去吧 [极大极小](https://platform.minimaxi.com/user-center/basic-information/interface-key) |
| 最小值\_API\_HOST | [https://api.minimax.io](https://api.minimax.io) | [https://api.minimaxi.com](https://api.minimaxi.com) |

### 克劳德桌面版

首选 `Claude > Settings > Developer > Edit Config > claude_desktop_config.json` 包括以下内容：

```
{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "insert-your-api-key-here",
        "MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
        "MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
        "MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
      }
    }
  }
}
```

⚠️ 警告：API密钥需要与主机匹配。如果出现错误“API错误：API密钥无效”，请检查您的API主机：

-   全球主机：`https://api.minimax.io`
-   大陆主办单位：`https://api.minimaxi.com`

如果您使用的是Windows，则必须在Claude Desktop中启用“开发人员模式”才能使用MCP服务器。单击左上角汉堡包菜单中的“帮助”，然后选择“启用开发人员模式”。

### 光标

首选 `Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server` 添加上述配置。

就是这样。您的MCP客户端现在可以通过以下工具与MiniMax交互：

## 运输

我们支持两种传输类型：stdio和sse。

|站起来|  
|:—–|:—–|  
|本地运行|可以在本地或云中部署|  
|沟通方式 `stdout` |沟通方式 `network` |  
|输入：支持处理 `local files` 或有效 `URL` resources |输入：在云中部署时，建议使用 `URL` 用于输入|

## 可用工具

| 工具  | 描述  |
| --- | --- |
| `text_to_audio` | 使用给定的语音将文本转换为音频 |
| `list_voices` | 列出所有可用的声音 |
| `voice_clone` | 使用提供的音频文件克隆语音 |
| `generate_video` | 根据提示生成视频 |
| `text_to_image` | 根据提示生成图像 |
| `query_video_generation` | 查询视频生成任务的结果 |
| `music_generation` | 根据提示和歌词生成音乐曲目 |
| `voice_design` | 使用预览文本从提示中生成语音 |

## 发布说明

### 2025年7月2日

#### 🆕 新增功能

-   **语音设计**新 `voice_design` 工具-根据带有预览音频的描述性提示创建自定义语音
-   **视频增强**：已添加 `MiniMax-Hailuo-02` 具有超清晰质量和持续时间/分辨率控制的模型
-   **音乐发生器**：增强 `music_generation` 工具由 `music-1.5` 模型

#### 📈 增强工具

-   `voice_design` -根据文本描述生成个性化语音
-   `generate_video` -现在支持MiniMax-Haileuo-02，持续时间为6s/10s，分辨率为768P/1080P
-   `music_generation` -音乐-1.5模型的高品质音乐创作

## 常见问题解答

### 1.无效的api密钥

请确保您的API密钥和API主机区域一致

| 地区  | 全球  | 大陆  |
| :--- | :--- | :--- |
| MINIMAX\_API\_KEY | 从获取 [MiniMax全球](https://www.minimax.io/platform/user-center/basic-information/interface-key) | 去吧 [极大极小](https://platform.minimaxi.com/user-center/basic-information/interface-key) |
| 最小值\_API\_HOST | [https://api.minimax.io](https://api.minimax.io) | [https://api.minimaxi.com](https://api.minimaxi.com) |

### 2.产卵

请在终端中运行以下命令确认其绝对路径：

```sh
which uvx
```

获得绝对路径（例如/usr/local/bin/uvx）后，更新配置以使用该路径（例如“command”：“/usr/local/bin/uvx”）。

### 3.如何使用 `generate_video` 在异步模式下

开始前定义完成规则：

或者，可以在IDE设置中配置这些规则（例如Cursor）：

## 示例用法

⚠️ 警告：使用这些工具可能会产生成本。

### 1.播放一段晚间新闻

### 2.克隆声音

### 3.生成视频

### 4.生成图像



---