语音克隆 - ChatfireAPI

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

upstream_api_key

string

必需

示例值:

1926727132189303566|eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJHcm91cE5hbWUiOiJ4eCIsIlVzZXJOYW1lIjoieHgiLCJBY2NvdW50IjoiIiwiU3ViamVjdElEIjoiMTkyNjcyNzEzMjE5MzQ5Nzg3MCIsIlBob25lIjoiMTkyODQ0MzI1MzMiLCJHcm91cElEIjoiMTkyNjcyNzEzMjE4OTMwMzU2NiIsIlBhZ2VOYW1lIjoiIiwiTWFpbCI6IiIsIkNyZWF0ZVRpbWUiOiIyMDI1LTA1LTI3IDE4OjM1OjIzIiwiVG9rZW5UeXBlIjoyLCJpc3MiOiJtaW5pbWF4In0.yUlyEhtMUI4hr61vkd3rtpVFwMI3qxCDrULaU9AnO8-eyS_yk9s778W8mB62kDSCpXU93xZXLkukhGT88WrrbRvwJsd2j2jAz6UsVs5UfTQzcvJhSDgvTm3zQCOwobRezwXaettGQAiWdaJMBhsjf9X79ISGmwk8Md1jVIH8xIAbrHGGcwx5xEriSQGvlqYaPejoK9LjhVuHXVT-lLvU7Qg6saTaQ--pvmai92JqKb8YIUigfy2zLQImm9iv9W-aWn3pO3ddiaapH49ym6zZi6AgeQmGWu1298I2IsBEZvIrbKVt6vBuryFRUuOUQ3H1omM0GMNy0JEEVU8ACvBh-g

Body 参数multipart/form-data

file_id

integer <int64>

可选

音频复刻参数。复刻音频的file_id。支持mp3、m4a、wav格式。注意：上传的音频文件时长最少应不低于10秒，最长应不超过5分钟；文件大小需不超过20mb。

voice_id

string

可选

音频复刻参数。用户可自定义的voice_id，如果创建的voice_id与之前重复则会报错。正确示例如下：MiniMax001

>= 8 字符<= 256 字符

示例值:

MyCustomVoiceId001

正则匹配:

^[a-zA-Z](?:[a-zA-Z0-9_-]*[a-zA-Z0-9])?$

text_validation

string

必需

音色复刻增强参数。提供本参数及对应的一小段音频（时长小于8s）将有助于增强语音合成的音色相似度和稳定性。服务会对比音频与该文本的差异，若差异过大会返回错误码 1043。

<= 200 字符

text

string

必需

复刻试听参数。模型将使用复刻后的音色念诵本段文本内容，并以链接的形式将音频合成结果返回，供试听复刻效果。注：试听将根据字符数正常收取语音合成费用。

<= 2000 字符

model

enum<string>

必需

复刻试听参数。指定试听使用的语音模型，当提供 'text' 字段时，本字段为必填项。

枚举值:

speech-02-hdspeech-02-turbospeech-01-hdspeech-01-turbo

accuracy

number

必需

音频复刻参数。用于设置文本校验的准确率阈值。不传时，该字段值默认为0.7。

>= 0<= 1

默认值:

0.7

need_noise_reduction

boolean

必需

音频复刻参数。是否开启降噪。不传时，默认值为false。

默认值:

false

need_volume_normalization

string

必需

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://0.0.0.0:8000/minimax/v1/voice_clone' \
--header 'upstream_api_key: 1926727132189303566|eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJHcm91cE5hbWUiOiJ4eCIsIlVzZXJOYW1lIjoieHgiLCJBY2NvdW50IjoiIiwiU3ViamVjdElEIjoiMTkyNjcyNzEzMjE5MzQ5Nzg3MCIsIlBob25lIjoiMTkyODQ0MzI1MzMiLCJHcm91cElEIjoiMTkyNjcyNzEzMjE4OTMwMzU2NiIsIlBhZ2VOYW1lIjoiIiwiTWFpbCI6IiIsIkNyZWF0ZVRpbWUiOiIyMDI1LTA1LTI3IDE4OjM1OjIzIiwiVG9rZW5UeXBlIjoyLCJpc3MiOiJtaW5pbWF4In0.yUlyEhtMUI4hr61vkd3rtpVFwMI3qxCDrULaU9AnO8-eyS_yk9s778W8mB62kDSCpXU93xZXLkukhGT88WrrbRvwJsd2j2jAz6UsVs5UfTQzcvJhSDgvTm3zQCOwobRezwXaettGQAiWdaJMBhsjf9X79ISGmwk8Md1jVIH8xIAbrHGGcwx5xEriSQGvlqYaPejoK9LjhVuHXVT-lLvU7Qg6saTaQ--pvmai92JqKb8YIUigfy2zLQImm9iv9W-aWn3pO3ddiaapH49ym6zZi6AgeQmGWu1298I2IsBEZvIrbKVt6vBuryFRUuOUQ3H1omM0GMNy0JEEVU8ACvBh-g' \
--form 'file_id=""' \
--form 'voice_id=""' \
--form 'text_validation=""' \
--form 'text=""' \
--form 'model=""' \
--form 'accuracy=""' \
--form 'need_noise_reduction=""' \
--form 'need_volume_normalization=""'

返回响应

🟢200成功

application/json

Body

data

object

必需

audio

string

必需

status

integer

必需

ced

string

必需

extra_info

object

必需

audio_length

integer

必需

audio_sample_rate

integer

必需

audio_size

integer

必需

bitrate

integer

必需

word_count

integer

必需

invisible_character_ratio

integer

必需

usage_characters

integer

必需

audio_format

string

必需

audio_channel

integer

必需

trace_id

string

必需

base_resp

object

必需

status_code

integer

必需

status_msg

string

必需

示例

{
    "data": {
        "audio": "https://s3.ffire.cc/cdn/20250716/9wpWvn2kk8hvj5QBH2YLyt.mp3",
        "status": 2,
        "ced": ""
    },
    "extra_info": {
        "audio_length": 10080,
        "audio_sample_rate": 32000,
        "audio_size": 163205,
        "bitrate": 128000,
        "word_count": 52,
        "invisible_character_ratio": 0,
        "usage_characters": 101,
        "audio_format": "mp3",
        "audio_channel": 1
    },
    "trace_id": "04c64ed2c05a67152ffb85cc4c685817",
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    }
}