MiniMax
  1. T2A Large API 接口
MiniMax
  • 公告通知
  • 产品定价
  • 概述
  • FAQ
  • 大模型介绍
    • 文本大模型
    • 语音大模型
  • 接入说明
    • 新手指南
    • 速率说明
  • 开发指南
    • 快速开始
  • 文本大模型接口
    • ChatCompletion Pro(对话)
      • 概述
      • ChatCompletion Pro API 文档
        • ChatCompletion Pro API
        • 示例对话功能
        • 限制返回格式功能(glyph)
        • 函数调用功能(function calling)
        • 插件功能(plugins)
        • 知识库检索功能(retrieval)
    • ChatCompletion(对话)
      • 概述
      • ChatCompletion 快速接入
      • ChatCompletion 调优指南
      • ChatCompletion API 文档
        • ChatCompletion API
        • 知识库检索功能(retrieval)
  • Assistants 接口
    • Assistants 操作指南
    • Assistans API 文档
      • Assistant
        • 创建 Assistant
        • 检索 Assistants
        • 删除 assistant
        • 查看 assistant 列表
      • Assistant File
        • 创建 assistant 文件
        • 检索 assistant 关联的文件
        • 列出 assistant 文件
      • Thread
        • 创建 thread
        • 检索 thread
      • Message
        • 创建 message
        • 检索 message
        • message 列表
      • Run
        • 创建 run
        • 检索 run
        • 列表 run
        • Submit tool outputs to run
      • Run Step
        • 检索 run step
        • 列表 run step
  • File(文档)
    • File(文档)
      GET
    • Upload 接口
      GET
    • Retrieve 接口
      GET
    • Delete 接口
      POST
    • RetrieveContent 接口
      GET
  • Retrieval(知识库检索)
    • 新建知识库
    • 删除知识库
    • 查看知识库详情
    • 查看知识库列表
    • 增加知识库文档
    • 删除知识库文档
    • 修改知识库文档
    • 查看知识库文档
    • 检索 Chatcompletion
    • 检索 Chatcompletion pro
  • 微调
    • Finetune 操作指南
    • Finetune API文档
      • 创建微调任务
      • 列出微调任务
      • 检索微调任务
      • 删除微调任务
      • 列出微调事件
      • 列举微调模型
      • 查询微调模型
      • 删除微调模型
  • 向量化
    • Embeddings(向量化)
  • 语音大模型接口
    • T2A (语音生成)
      • T2A 快速接入
      • T2A API 接口
        • T2A API接口
        • 字典功能(Dictionary)
    • T2A pro(长文本语音生成)
      • T2A Pro 快速接入
      • T2A Pro API 接口
      • 字典功能(Dictionary)
    • T2A large(异步超长文本语音生成)
      • T2A Large 快速接入
      • T2A Large API 接口
        • T2A Large API 接口
          GET
        • 字典功能(Dictionary)
          POST
    • T2A Stream(流式语音生成)
      • T2A Stream(流式语音生成)
      • 字典功能(Dictionary)
    • 快速复刻(Voice Cloning)
      • 上传文件
      • 音频复刻
  • 有声内容创作
    • Role Classification (文本角色分类)
      • 创建并异步运行角色识别任务
      • 查询角色识别任务
    • Role Audio Generation (角色音频生成)
      • 角色音频生成
  1. T2A Large API 接口

字典功能(Dictionary)

开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v1/text_to_speech
该功能支持字典接入能力,帮助语音模型更准确的识别汉字对应的读音。
该功能的请求参数格式应为:纯文本或者TXT格式。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v1/text_to_speech?GroupId=
$group_id' \
--header 'Authorization: Bearer $
{api_key}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "voice_id": "male-qn-qingse",// 如同时传入voice_id和timber_weights时,则会自动忽略voice_id,以timber_weights传递的参数为准
    "text": "你好",//如需要控制停顿时长,则增加输入<#X#>,X取值0.01-99.99,单位为秒,如:你<#5#>好(你与好中间停顿5秒)
    "model": "speech-01",
    "speed": 1.0,
    "vol": 1.0,
    "pitch": 0,
    "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
        }
    ],
    "char_to_pitch": ["你/(ni1)"]
}'
响应示例响应示例
{}

请求参数

Query 参数
GroupId
string 
必需
示例值:
$group_id
Header 参数
Authorization
string 
必需
示例值:
Bearer $ {api_key}
Content-Type
string 
必需
示例值:
application/json
Body 参数application/json
voice_id
string 
请求的音色编号
可选
如同时传入voice_id和timber_weights时,则会自动忽略voice_id,以timber_weights传递的参数为准
text
string 
期望生成声音的文本
必需

如需要控制停顿时长,则增加输入<#X#>,X取值0.01-99.99,单位为秒,如:你<#5#>好(你与好中间停顿5秒)

model
string 
必需
speed
integer 
生成声音的语速
可选
可选,默认值为1.0取值越大,语速越快
vol
integer 
生成声音的音量
可选
可选,默认值为1.0取值越大,音量越高
pitch
integer 
生成声音的语调
可选
可选,默认值为0(0为原音色输出,取值需为整数)
timber_weights
array [object {2}] 
音色相关信息
可选
音色相关信息,详见下方字段
voice_id
string 
必需
weight
integer 
必需
char_to_pitch
array[string]
替换需要特殊标注的文字、符号及对应的注音
可选
示例1,替换声调:["燕少飞/(yan4)(shao3)(fei1)"]示例2,替换字符:["omg/oh my god","=/等于"]声调用数字代替,一声(阴平)为1,二声(阳平)为2,三声(上声)为3,四声(去声)为4),轻声为5
示例

返回响应

🟢200成功
application/json
Body
object {0}
上一页
T2A Large API 接口
下一页
T2A Stream(流式语音生成)
Built with