MinMax开放平台连接器

连接器

需两次购买：①订购原厂商接口 ②订购易源会员包代理转发；MiniMax开放平台为企业客户和专业开发者提供服务，包括两种基于大型语言模型的API：文本到文本（T2T）和文本到语音（T2A）。T2T适用于互动娱乐和基于自然语言的生产力提升，如文本创作和改写。T2A适用于语音播报和语音交互。

会员资源包统一计费，无需单独购买，开通会员包后可直接调用。

T2A_pro_长文本语音生成

接入点说明

接口支持基于自然语言交互生成回复的能力。接口本身为无状态接口，即单次调用时，模型所接收到的信息量仅为接口传入内容，不涉及业务逻辑，同时模型也不存储您传入的数据。

支持单次合成最高50000字符输入；

支持语调、语速、音量、比特率、采样率相关参数调整特性；

支持音频时长、音频大小等返回参数；

支持时间戳（字幕）返回，精确到句；

支持混音功能，最多四种音色按照比例混合；

支持非法字符检测：非法字符不超过10%（包含10%），音频会正常生成并返回非法字符占比；非法字符超过10%，接口不返回结果（返回报错码），请检测后再次进行请求（非法字符定义：ascii码中的控制符（不含制表符和换行符））；

适用场景：长文本有声化、书籍小说等文字单章节语音合成、录播课程语音合成等

接口地址

https://connector.showapi.com/3102-5?appKey={your_appKey}查看密钥调用帮助

返回格式JSON

请求方式POST

请求参数

Header 参数

参数名称	类型	示例值	必须	描述
ds_id	String	-	否
Content-Type	String	application/json	否

URI 参数

参数名称	类型	示例值	必须	描述
GroupId	String	1699319855590621	是	该值应拼接在调用API的url末尾。用户的groupid，可在查看MinMax用户中心查看https://api.minimax.chat/user-center/basic-information

请求 Body 体

body

{
    "voice_id": "male-qn-qingse",
    "text": "【万维易源】以领先的API数据服务及系列产品为用户提供基于大数据的API服务。解决API数据买卖双方缺乏交易场所、技术标准、财务流程、第三方担保、运营维护、客户服务、SDK支持等问题，提供统一的API调用标准，将核心技术开放给生态链上下游合作伙伴，推进互联网时代的数据服务发展，让使用网络数据像水、电一样容易、自由和便宜。帮助用户快速获取API数据高效开发，极大降低开发运营成本，为用户产生价值。",
    "model": "speech-01",
    "speed": 1.0,
    "vol": 1.0,
    "pitch": 0,
    "audio_sample_rate": 24000,
    "bitrate": 128000,
    "timber_weights": [
        {
            "voice_id": "male-qn-qingse",
            "weight": 1
        },
        {
            "voice_id": "female-shaonv",
            "weight": 1
        },
        {
            "voice_id": "female-yujie",
            "weight": 1
        },
        {
            "voice_id": "audiobook_male_2",
            "weight": 1
        }
    ]
}

返回参数

该接口为透传模式，直接返回服务商原始数据，无 showapi_res_body 封装。

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/3102-5?appKey=YOUR_APPKEY" \
  -H "ds_id: " \
  -H "Content-Type: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_id": "male-qn-qingse",
    "text": "【万维易源】以领先的API数据服务及系列产品为用户提供基于大数据的API服务。解决API数据买卖双方缺乏交易场所、技术标准、财务流程、第三方担保、运营维护、客户服务、SDK支持等问题，提供统一的API调用标准，将核心技术开放给生态链上下游合作伙伴，推进互联网时代的数据服务发展，让使用网络数据像水、电一样容易、自由和便宜。帮助用户快速获取API数据高效开发，极大降低开发运营成本，为用户产生价值。",
    "model": "speech-01",
    "speed": 1.0,
    "vol": 1.0,
    "pitch": 0,
    "audio_sample_rate": 24000,
    "bitrate": 128000,
    "timber_weights": [
        {
            "voice_id": "male-qn-qingse",
            "weight": 1
        },
        {
            "voice_id": "female-shaonv",
            "weight": 1
        },
        {
            "voice_id": "female-yujie",
            "weight": 1
        },
        {
            "voice_id": "audiobook_male_2",
            "weight": 1
        }
    ]
}'

返回示例

JSON

{
  "audio_file": "https://xxxxx/xxx.mp3",
  "subtitle_file": "https://xxxxx/xxx.titles",
  "trace_id": "xxxxxxxxxx",
  "extra_info": {
    "audio_length": 1946,
    "audio_sample_rate": 32000, 
    "audio_size": 8253, 
    "bitrate": 32000,
    "word_count": 10,
    "invisible_character_ratio": 0.04
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

MCP 服务集成接口级

在 Cherry Studio、ChatBox 等支持 MCP 的客户端中配置，将 {your_appKey} 替换为真实 AppKey（AppKey 管理）。该服务覆盖本接口全部接入点。

MCP JSON

{
  "mcpServers": {
    "showapi-mcp-3102": {
      "url": "http://www.showapi.com.cn/mcp/3102/{your_appKey}"
    }
  }
}

OpenAPI 文档接口级

标准 OpenAPI 3.0 文档，覆盖本接口全部接入点，可导入 Apifox / Postman / Swagger UI，或供 AI Agent 直接消费。

在线查看 YAML

下载 YAML

查看 JSON