> ## Documentation Index > Fetch the complete documentation index at: https://platform.minimaxi.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # 接口概览 > MiniMax 开放平台 API 接口能力概览，包括语言、视频、语音、图像、音乐和文件管理等多模态能力。 ## 获取 API Key * **按量付费**：通过 [接口密钥 > 创建新的 API Key](https://platform.minimax.cn/user-center/basic-information/interface-key)，获取 **API Key** * **M Plan**：通过 [订阅管理 > M Plan](https://platform.minimax.cn/user-center/payment/token-plan)，查看 **订阅 Key** 订阅 Key 用于 M Plan 订阅套餐和已购积分，并与按量计费 API Key 相互独立。详情见 [M Plan 概要](https://platform.minimax.cn/docs/m-plan/intro) *** ## 语言模型语言模型接口使用 **MiniMax M3.1-Flash-Preview**，**MiniMax M3**，**MiniMax M2.7**，**MiniMax M2.7-highspeed**，**MiniMax M2.5**，**MiniMax M2.5-highspeed**，**MiniMax M2.1**，**MiniMax M2.1-highspeed**，**MiniMax M2** 根据输入的上下文，让模型生成对话内容、工具调用。 MiniMax-M3.1-Flash-Preview 暂时仅通过 M Plan 和 MiniMax Code 提供。可通过 **HTTP** 请求、**Anthropic SDK**（推荐）或 **OpenAI SDK** 接入。 **支持模型** | 模型名称 | 输入输出总 token | 模型介绍 | | :- | :-: | :- | | MiniMax-M3.1-Flash-Preview | 1,000,000 | **原生多模态、1M 上下文的 Frontier Coding 模型，思考深度可调** | | MiniMax-M3 | 1,000,000 | **原生多模态、1M 上下文的 Frontier Coding 模型**（输出速度约 100+ TPS） | | MiniMax-M2.7 | 204800 | **开启模型的自我迭代 (输出速度约60tps)** | | MiniMax-M2.7-highspeed | 204800 | **M2.7 极速版：效果不变，更快，更敏捷 (输出速度约100tps)** | | 模型名称 | 输入输出总 token | 模型介绍 | | :- | :-: | :- | | MiniMax-M2.5 | 204800 | **顶尖性能与极致性价比，轻松驾驭复杂任务 (输出速度约60tps)** | | MiniMax-M2.5-highspeed | 204800 | **M2.5 极速版：效果不变，更快，更敏捷 (输出速度约100tps)** | | MiniMax-M2.1 | 204800 | **强大多语言编程能力，全面升级编程体验 (输出速度约60tps)** | | MiniMax-M2.1-highspeed | 204800 | **M2.1 极速版：效果不变，更快，更敏捷 (输出速度约100tps)** | | MiniMax-M2 | 204800 | **专为高效编码与Agent工作流而生** | 如果在使用模型过程中遇到任何问题： * 通过邮箱 [Model@minimaxi.com](mailto:Model@minimaxi.com) 等官方渠道联系我们的技术支持团队 * 在我们的 [Github](https://github.com/MiniMax-AI/MiniMax-M2/issues) 仓库提交Issue 通过 Anthropic SDK 调用 MiniMax 模型通过 OpenAI SDK 调用 MiniMax 模型 *** ## 视频模型本接口支持文本、图片、视频、音频等多模态输入进行视频生成，覆盖文生视频、图生视频、首尾帧生成视频、多模态参考生视频等场景。 **支持模型** | 模型 | 功能 | | :- | :- | | MiniMax-H3 | 多模态视频生成模型，支持文生 / 图生 / 首尾帧 / 多模态参考，768P / 2K 分辨率，4–15s 时长 | | MiniMax-H3-Max | 极速生成模型，支持文生 / 图生（首帧、尾帧）/ 多模态参考；480P / 768P 分辨率（不支持 2K），5–15s 时长 | **接口说明** 两个模型共用同一套 `content[]` 请求协议与查询接口，切换模型只需改 `model` 字段。MiniMax-H3 任务采用异步方式，提供**创建视频生成任务**、**创建 H3-Context-IR 任务**和**创建视频再生成任务**三个创建入口，并共用查询、列表以及取消或删除接口；MiniMax-H3-Max 仅支持**创建视频生成任务**入口。使用步骤如下： 1. 根据场景创建视频生成任务，使用相同的多模态输入创建 H3-Context-IR 任务，或对符合 MiniMax-H3 768P 输出规格的源视频创建视频再生成任务；再生成请求必须且只能包含一个 `role=base_video` 的源视频项。成功后均返回 `task_id`。 2. 使用**查询任务**接口按 `task_id` 获取状态与结果；视频任务成功后从 `content.url` 获取成片地址，H3-Context-IR 任务成功后从 `content.prompt` 获取增强提示词。也可以使用**查询任务列表**接口批量查看，并通过 `task_type` 区分 `generation`、`h3_context_ir` 与 `regeneration`。 3. 对排队中的任务，可使用**取消或删除任务**接口取消；对成功或失败的任务，可使用同一接口删除任务记录。基于多模态 content 输入创建视频生成任务深度理解视频生成的多模态上下文并生成结构化增强提示词将符合 MiniMax-H3 768P 输出规格的视频再生成为 2K 视频按 task\_id 查询任务状态并获取成片下载地址分页查询最近 7 天内的任务并按任务类型过滤取消排队中的任务，或删除成功和失败的任务记录 *** ## 语音模型语音模型提供**语音合成**、**音色复刻**与**音色设计**能力，支持 40 种语言、300+ 系统音色，可按需选择同步或异步方式生成。接口均为无状态设计：单次调用仅处理传入内容，不存储用户数据，不涉及业务逻辑状态。 **支持模型** | 模型 | 特性 | | :- | :- | | speech-2.8-hd | 最新的 HD 模型，情绪渲染融合语气词，重塑自然听感 | | speech-2.8-turbo | 最新的 Turbo 模型，极致生成速度，更自然逼真的音频效果 | | speech-2.6-hd | HD 模型，韵律表现出色，极致音质与韵律表现，生成更快更自然 | | speech-2.6-turbo | Turbo 模型，音质优异，超低时延，响应更灵敏 | | speech-02-hd | 拥有出色的韵律、稳定性和复刻相似度，音质表现突出 | | speech-02-turbo | 拥有出色的韵律和稳定性，小语种能力加强，性能表现出色 | **接口说明** 四类能力共用上述模型： 1. **同步语音合成**：文本实时转语音，单次最长 **10,000 字符**；支持 300+ 系统音色与复刻音色、音量/语调/语速调整、按比例混音、流式输出，输出格式含 mp3、pcm、flac、wav。提供 **HTTP** 与 **WebSocket** 两种接入方式。 2. **异步长文本语音合成**：单次最长 **100 万字符**，适合整本书籍等长文本；支持句级时间戳（字幕）。创建任务得到 `task_id`，查询成功后用返回的 `file_id` 经文件接口下载（下载 URL 自返回起 **9 小时**内有效）。 3. **音色快速复刻**：上传待复刻音频获取 `file_id`（可选再上传示例音频增强效果），再调用快速复刻生成自定义 `voice_id`。需先完成个人或企业认证。 4. **音色设计**：基于声音描述 prompt 生成个性化音色，产出的 `voice_id` 可直接用于上述合成接口。音色复刻与音色设计产出的均为**临时音色**：费用在首次用于语音合成时才收取（不含接口内试听）；若 \*\*168 小时（7 天）\*\*内未在任意语音合成接口中使用，该音色将被删除。 | 支持语种 | | | | :- | :- | :- | | 1. 中文（Chinese） | 15. 土耳其语（Turkish） | 28. 马来语（Malay） | | 2. 粤语（Cantonese） | 16. 荷兰语（Dutch） | 29. 波斯语（Persian） | | 3. 英语（English） | 17. 乌克兰语（Ukrainian） | 30. 斯洛伐克语（Slovak） | | 4. 西班牙语（Spanish） | 18. 泰语（Thai） | 31. 瑞典语（Swedish） | | 5. 法语（French） | 19. 波兰语（Polish） | 32. 克罗地亚语（Croatian） | | 6. 俄语（Russian） | 20. 罗马尼亚语（Romanian） | 33. 菲律宾语（Filipino） | | 7. 德语（German） | 21. 希腊语（Greek） | 34. 匈牙利语（Hungarian） | | 8. 葡萄牙语（Portuguese） | 22. 捷克语（Czech） | 35. 挪威语（Norwegian） | | 9. 阿拉伯语（Arabic） | 23. 芬兰语（Finnish） | 36. 斯洛文尼亚语（Slovenian） | | 10. 意大利语（Italian） | 24. 印地语（Hindi） | 37. 加泰罗尼亚语（Catalan） | | 11. 日语（Japanese） | 25. 保加利亚语（Bulgarian） | 38. 尼诺斯克语（Nynorsk） | | 12. 韩语（Korean） | 26. 丹麦语（Danish） | 39. 泰米尔语（Tamil） | | 13. 印尼语（Indonesian） | 27. 希伯来语（Hebrew） | 40. 阿非利卡语（Afrikaans） | | 14. 越南语（Vietnamese） | | | 通过 HTTP 请求进行语音合成通过 WebSocket 进行流式语音合成创建长文本语音生成任务查询语音生成任务状态上传待克隆的音频文件执行音色克隆基于描述生成个性化音色 *** ## 图片生成本接口支持基于用户提供的文本或参考图片，进行创意图像生成。支持设置不同图片比例和长宽像素设置，满足不同场景下图像需求。 **接口说明** 通过创建图片生成任务接口，使用文本描述和参考图片，进行图像生成。 **模型列表** | 模型名称 | 简介 | | :- | :- | | image-01 | 图像生成模型，画面表现细腻，支持文生图、图生图（人物主体参考） | | image-01-live | 图像生成模型，在 image-01 基础上额外支持多种画风设置 | 基于文本描述生成图像基于参考图片生成图像 *** ## 音乐生成自 2026 年 8 月 20 日起，付费接口（音乐生成、歌词生成）不再面向新用户提供服务，历史付费用户可继续使用现有 API 服务；免费音乐生成接口（Music-3.0-free、Music-2.6-free、music-cover-free）停止服务。如需体验或使用音乐生成能力，可前往 [MiniMax Audio](https://www.minimax.cn/audio)，或使用已发布在 [Hugging Face](https://huggingface.co/MiniMaxAI/MiniMax-Music3) 和 [魔搭 ModelScope](https://modelscope.cn/models/MiniMax/MiniMax-Music3) 的 MiniMax Music 3 开源模型。本接口根据歌曲描述（prompt）和歌词（lyrics），生成一首人声的歌曲。 **支持模型** | 模型名称 | 使用方法 | | :- | :- | | music-3.0 | 最新音乐生成模型，支持用户输入音乐灵感和歌词，生成 AI 音乐 | 根据描述和歌词生成音乐 *** ## 文件管理本接口是作为文件管理接口，配合 MiniMax 开放平台的其他接口使用。 **接口说明** 本接口是作为文件管理接口，配合其他接口使用。共包含 5 个接口：**上传**、**列出**、**检索**、**下载**、**删除**。文件的支持格式、容量及大小限制以**上传文件**接口文档为准，详见 [上传文件](/docs/api-reference/file-management-upload)。上传文件到平台获取已上传的文件列表 *** ## 工具 **Web Search** `web_search` 是由 MiniMax 在服务端托管和执行的联网搜索工具。模型可在生成回复时自动检索实时信息，并基于搜索结果作答；支持通过 Anthropic Messages API 和 OpenAI Responses API 调用。接口说明与示例详见 [Web Search](/docs/guides/server-tools#web_search)。 **官方 MCP** MiniMax 提供官方的 [Python 版本](https://github.com/MiniMax-AI/MiniMax-MCP) 和 [JavaScript 版本](https://github.com/MiniMax-AI/MiniMax-MCP-JS) 模型上下文协议（MCP）服务器实现代码，支持语音合成、音色克隆、视频生成、音乐生成等功能，详细说明请参考 [MiniMax MCP 使用指南](/docs/guides/mcp-guide)