GlobalAiOpcGlobalAiOpc
微信微信
登录
Model CenterGlobalAiOpc

MiniMax 语音合成

POST/kyyReactApiServer/v2/model-center/tasks

价格

登录后查看当前账号的价格及可用规格。请使用页面顶部的登录入口。
填写文本并选择音色，将文字转换为语音。可以使用系统音色，也可以使用声音克隆返回的 voice_id。
提交请求后返回 1 个任务 ID，通过查询接口获取生成结果。

快速开始

  1. 将下方示例中的 <API_KEY> 替换为你的 API 密钥，修改创作内容后提交请求。
  2. 保存响应中的 task_ids，逐个查询，每隔 3–5 秒查询一次即可。
  3. 当 status 为 completed 时，使用返回的文件链接获取作品。

请求地址

http
POST https://zcbservice.aizfw.cn/kyyReactApiServer/v2/model-center/tasks

认证

获取 Key
所有请求都需要 API 密钥。提交时使用以下请求头，将 <API_KEY> 替换为你的密钥。
http
Authorization: Bearer <API_KEY>
Content-Type: application/json

首次使用费用

首次使用先预扣一次性声音克隆费。合成请求被服务受理后确认收取，之后即使生成失败或文件交付失败，也不退这笔费用。请求明确被拒绝受理时退回未确认费用；受理结果不明时保留原扣费记录待核实。
这笔一次性费用与本次生成费分别结算。首次使用费用确认后，再次使用同一资源只收本次生成费；更换为另一个尚未付费的资源，则需要支付新资源的一次性费用。首次使用尚未确认时，请等待原请求处理，不要同时重复提交。

字符计费说明

价格按每 10,000 个计费字符标注，实际生成费 = 计费字符数 ÷ 10,000 × 单价。常用汉字每字计 2，其他 UTF-16 字符单元计 1。例如“你好abc”计 7 个计费字符。首次使用费用另行计算，不包含在每万字符单价中。

请求参数

以下参数放在请求体（JSON）中提交。标记“必填”的参数每次都要提供，其余参数按所选创作方式填写。
modelstring必填
填写此模型名称。
取值与限制：minimax-tts
textstring必填
需要朗读的文本。
取值与限制：至少 1 个字符; 最多 9999 个字符; 格式要求：\S
voice_settingobject必填
音色与朗读设置。首次调用只需填写 voice_id。
voice_setting.volnumber
音量，数值越大声音越响。
取值与限制：不大于 10; 大于 0; 原文默认值（平台不自动填入）：1
voice_setting.pitchinteger
语调，0 表示保持原音色语调。
取值与限制：取值 -12–12; 原文默认值（平台不自动填入）：0
voice_setting.speednumber
语速，数值越大朗读越快。
取值与限制：取值 0.5–2; 原文默认值（平台不自动填入）：1
voice_setting.emotionstring
朗读情绪。可省略，由模型自然演绎。
取值与限制：可选值："happy"；"sad"；"angry"；"fearful"；"disgusted"；"surprised"；"calm"；"fluent"；"whisper"
voice_setting.voice_idstring
填写该对象时必填
填写可用的系统音色 ID，或声音克隆成功后返回的 voice_id。克隆音色只能由所属账号使用。
取值与限制：至少 1 个字符; 格式要求：\S
voice_setting.latex_readboolean
控制是否朗读 latex 公式，默认为 false 需注意: - 仅支持中文，开启该参数后，language_boost 参数会被设置为 Chinese - 请求中的公式需要在公式的首尾加上 $$ - 请求中公式若有 "\"，需转义成 "\\". 示例：一元二次方程根的基本公式 The quadratic formula 应表示为 $$x = \\frac&#123;-b \\pm \\sqrt&#123;b^2 - 4ac&#125;&#125;&#123;2a&#125;$$
取值与限制：原文默认值（平台不自动填入）：false
voice_setting.text_normalizationboolean
废弃参数，请使用请求体一级参数 text_normalization_mode：本参数为 true 等价于 text_normalization_mode=basic；为 false 或不传等价于不传 text_normalization_mode。两者同时传入时以 text_normalization_mode 为准 是否启用中文、英语文本规范化，开启后可提升数字阅读场景的性能，但会略微增加延迟，默认值为 false
取值与限制：原文默认值（平台不自动填入）：false
language_booststring
指定朗读语种；auto 表示自动判断。
取值与限制：可选值："Chinese"；"Chinese,Yue"；"English"；"Arabic"；"Russian"；"Spanish"；"French"；"Portuguese"；"German"；"Turkish"；"Dutch"；"Ukrainian"；"Vietnamese"；"Indonesian"；"Japanese"；"Italian"；"Korean"；"Thai"；"Polish"；"Romanian"；"Greek"；"Czech"；"Finnish"；"Hindi"；"Bulgarian"；"Danish"；"Hebrew"；"Malay"；"Persian"；"Slovak"；"Swedish"；"Croatian"；"Filipino"；"Hungarian"；"Norwegian"；"Slovenian"；"Catalan"；"Nynorsk"；"Tamil"；"Afrikaans"；"auto"
upstream_modelstring必填
使用的语音模型版本，请按下方可选值填写。
取值与限制：可选值："speech-2.8-hd"；"speech-2.8-turbo"；"speech-2.6-hd"；"speech-2.6-turbo"；"speech-02-hd"；"speech-02-turbo"；"speech-01-hd"；"speech-01-turbo"
text_normalization_modestring
文本归一化模式。basic 使用快速的规则归一化；quality 采用 LLM + 规则的混合方案，归一化质量更高，但会增加一定延迟。详见文本归一化。 注意： - quality 目前仅对非流式请求（stream=false）生效，且仅支持 speech-2.8-hd、speech-2.8-turbo、speech-2.6-hd、speech-2.6-turbo；流式请求或其他模型传入 quality 时按 basic 处理，不会报错 - 传入本参数后，voice_setting.text_normalization 不再生效；不传时沿用 voice_setting.text_normalization 的设置（默认关闭）
取值与限制：可选值："basic"；"quality"

请求示例

选择创作方式查看请求内容。右侧提供 cURL、Python、JavaScript 完整调用代码；Python 示例需先安装 requests，JavaScript 示例可使用 Node.js 18+。
JSON
{
  "model": "minimax-tts",
  "text": "你好，这是同步语音合成示例。",
  "voice_setting": {
    "voice_id": "male-qn-qingse"
  },
  "upstream_model": "speech-2.8-hd"
}

提交响应

请求成功返回 HTTP 202，表示已开始排队。作品生成需要时间，请继续查询任务。
字段说明
task_ids本次生成的全部任务 ID。请保存并逐个查询，避免遗漏作品。
id第一个任务的 ID。
statusqueued 表示排队中。
error错误信息；无错误时为 null。

查询结果

http
GET https://zcbservice.aizfw.cn/kyyReactApiServer/v2/model-center/tasks/{task_id}
task_idstring必填
将地址中的 {task_id} 替换为提交响应 task_ids 中的一个值，并使用同一个 API 密钥查询。每个任务分别查询，保存并使用全部任务 ID。

任务状态

status含义下一步
queued排队中等待 3–5 秒后再次查询。
processing处理中（生成或文件交付）等待 3–5 秒后再次查询。
completed已完成读取返回的业务字段，使用媒体地址播放或下载。
failed生成失败查看 error 了解原因；退款进度见 refund_status。
delivery_exception作品生成成功，但文件暂时无法获取停止轮询，联系支持处理；不要重复提交。
manual_required任务需要人工核查停止轮询，保留任务 ID 并联系支持；不要重复提交。

完成响应示例

JSON
{
  "id": "mcp_00000000000000000000000000000001",
  "model": "minimax-tts",
  "object": "audio",
  "created": 1792022400,
  "status": "completed",
  "amount": 0.25,
  "billing_status": "deducted",
  "refund_status": "none",
  "usage_characters": 0,
  "audio_url": "https://storage.example.com/audio.bin",
  "error": null
}
示例地址和积分仅作说明。实际费用以账户配置及任务记录为准；只有 completed 状态才可获取生成文件。

返回字段

字段说明
id当前查询的任务 ID。
model使用的模型名称。
object结果类型，例如 audio、video。
created任务创建时间，Unix 时间戳，单位为秒。
status任务状态，completed 表示完成。
amount / billing_status / refund_status该任务消耗的积分、扣费状态和退款状态。
error错误信息；成功时为 null。
error_code发生错误时返回的平台错误代码。
媒体地址字段说明
audio_url音频播放或下载链接；完成时返回

结果字段

字段类型必返说明
usage_charactersinteger否本次合成返回的字符数；实际扣费请查看 amount。
返回的媒体地址均为平台保存后的地址，可直接用于播放或下载。可选文件未交付时不返回对应地址。

费用与常见问题

每个任务单独计费，生成失败后可通过 refund_status 查看退款进度。
  • 提交超时：请先确认原请求是否成功，避免重复生成和扣费；已有任务 ID 时直接查询该任务。
  • 查询暂时失败：稍后使用原任务 ID 重试查询，不需要重新生成。
  • 返回 delivery_exception：生成费用保留，请联系支持恢复文件。