Model CenterGlobalAiOpc

MiniMax声音克隆

POST/kyyReactApiServer/v2/model-center/tasks

价格

登录后查看当前账号的价格及可用规格。请使用页面顶部的登录入口。

提供参考音频链接和试听文本，创建音色并生成试听音频。本模型要求试听文本，费用按下方价格计算。创建成功后，用返回的 voice_id 调用语音合成。

提交请求后返回 1 个任务 ID，通过查询接口获取生成结果。

快速开始

按下方必填与默认值说明提供参考音频链接、试听文本和模型参数，使用你的 API 密钥提交请求。
保存返回的任务 ID，每隔 3–5 秒查询一次。
当 status 为 completed 时，保存 voice_id 和试听链接。

请求地址

http

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

认证

获取 Key

所有请求都需要 API 密钥。提交时使用以下请求头，将 <API_KEY> 替换为你的密钥。

http

Authorization: Bearer <API_KEY>
Content-Type: application/json

准备素材

填写可直接下载的公网 HTTP/HTTPS 素材链接，无需发送文件内容或开通域名。文件格式和大小须符合参数说明。提交后保存任务 ID，并查询处理结果；如果本接口包含试听，完成后可获取试听链接和音色 ID。

使用克隆音色

创建完成后保存返回的 voice_id。调用语音合成时，将它填入 voice_setting.voice_id，并填写要朗读的 text。试听链接用于试听，不能代替音色 ID。

查询已创建的音色：GET /v2/model-center/tasks/resources?resource_type=voice&limit=24。克隆音色仅限所属账号使用。

字符计费说明

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

请求参数

以下参数放在请求体（JSON）中提交。标记“必填”的参数每次都要提供，其余参数按所选创作方式填写。

modelstring必填

填写此模型名称。

取值与限制：minimax_voice_clone

textstring必填

用于生成试听音频的文本。

取值与限制：至少 1 个字符; 最多 1000 个字符; 格式要求：\S

file_urlstring必填

用于复刻声音的参考音频链接。请提供可直接下载的公网地址。支持格式：MP3。

取值与限制：格式要求：^https?://

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"

need_noise_reductionboolean

是否对参考音频降噪。

need_volume_normalizationboolean

是否统一参考音频音量。

请求示例

选择创作方式查看请求内容。右侧提供 cURL、Python、JavaScript 完整调用代码；Python 示例需先安装 requests，JavaScript 示例可使用 Node.js 18+。

JSON

{
  "model": "minimax_voice_clone",
  "text": "你好，这是我的声音试听。",
  "file_url": "https://media.example.com/sample.mp3",
  "language_boost": "Chinese",
  "upstream_model": "speech-2.8-hd"
}

提交响应

请求成功返回 HTTP 202，表示已开始排队。作品生成需要时间，请继续查询任务。

字段	说明
task_ids	本次生成的全部任务 ID。请保存并逐个查询，避免遗漏作品。
id	第一个任务的 ID。
status	queued 表示排队中。
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 并联系支持；不要重复提交。

完成响应示例

以下示例包含已请求并交付的附加文件。未满足下方媒体字段的输入条件时，不返回该文件地址；创建资源成功后仍会返回资源 ID。

JSON

{
  "id": "mcp_00000000000000000000000000000001",
  "model": "minimax_voice_clone",
  "object": "audio",
  "created": 1792022400,
  "status": "completed",
  "amount": 0.25,
  "billing_status": "deducted",
  "refund_status": "none",
  "voice_id": "mcr_0123456789abcdef0123456789abcdef",
  "preview_url": "https://storage.example.com/preview.bin",
  "error": null
}

示例地址和积分仅作说明。实际费用以账户配置及任务记录为准；只有 completed 状态才可获取生成文件。

返回字段

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

媒体地址字段	说明
preview_url	音频播放或下载链接；填写 text 时交付，保存成功后才返回 completed

结果字段

字段	类型	必返	说明
voice_id	string	是	音色 ID，保存后用于语音合成。

返回的媒体地址均为平台保存后的地址，可直接用于播放或下载。可选文件未交付时不返回对应地址。

费用与常见问题

每个任务单独计费，生成失败后可通过 refund_status 查看退款进度。

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