语音合成 - ChatfireAPI

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

upstream_api_key

string

必需

示例值:

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

Body 参数application/json

语音合成请求体

可选

用于配置语音合成任务的参数

One of

object

model

enum<string>

请求的模型版本

必需

枚举值:

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

text

string

必需

待合成的文本。长度限制<10000字符，段落切换用换行符替代。（如需控制语音中间隔时间，在字间增加<#x#>,x单位为秒，支持0.01-99.99，最多两位小数）。支持自定义文本与文本之间的语音时间间隔，以实现自定义文本语音停顿时间的效果。注意：时间间隔需设置在两个可发音的文本之间，且不能设置多个连续的时间间隔。

<= 9999 字符

voice_setting

object

可选

语音设置（具体参数请展开）

audio_setting

object

可选

音频设置（具体参数请展开）

pronunciation_dict

object

可选

发音词典（具体参数请展开）

timber_weights

object

必需

音色权重（具体参数请展开），与 voice_id 二选一必填

voice_id

string

可选

音色ID，与 timber_weights 二选一必填

stream

boolean

可选

是否流式。默认false，即不开启流式。

默认值:

false

stream_options

object

可选

流式选项（具体参数请展开）

language_boost

enum<string> | enum<null>

可选

增强对指定的小语种和方言的识别能力，设置后可以提升在指定小语种/方言场景下的语音表现。如果不明确小语种类型，则可以选择'auto'，模型将自主判断小语种类型。

枚举值:

nullChineseChinese,YueEnglishArabicRussianSpanishFrenchPortugueseGermanTurkishDutchUkrainianVietnameseIndonesianJapaneseItalianKoreanThaiPolishRomanianGreekCzechFinnishHindiauto

默认值:

null

subtitle_enable

boolean

可选

控制是否开启字幕服务的开关。默认为false。此参数仅对 speech-01-turbo 和 speech-01-hd 有效。

默认值:

false

output_format

enum<string>

可选

控制输出结果形式的参数。可选值为 'url' 或 'hex'。默认值为 'hex'。该参数仅在非流式场景生效，流式场景仅支持返回hex形式。返回的url有效期为24小时。

枚举值:

urlhex

默认值:

hex

示例

{
    "model": "speech-02-hd",
    "text": "真正的危险不是计算机开始像人一样思考，而是人开始像计算机一样思考。计算机只是可以帮我们处理一些简单事务。",
    "stream": false,
    "voice_setting": {
        "voice_id": "male-qn-qingse",
        "speed": 1,
        "vol": 1,
        "pitch": 0,
        "emotion": "happy"
    },
    "pronunciation_dict": {
        "tone": [
            "处理/(chu3)(li3)",
            "危险/dangerous"
        ]
    },
    "audio_setting": {
        "sample_rate": 32000,
        "bitrate": 128000,
        "format": "mp3",
        "channel": 1
    },
    // "response_format": "url",
}

示例代码

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/t2a_v2' \
--header 'upstream_api_key: 1926727132189303566|eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJHcm91cE5hbWUiOiJ4eCIsIlVzZXJOYW1lIjoieHgiLCJBY2NvdW50IjoiIiwiU3ViamVjdElEIjoiMTkyNjcyNzEzMjE5MzQ5Nzg3MCIsIlBob25lIjoiMTkyODQ0MzI1MzMiLCJHcm91cElEIjoiMTkyNjcyNzEzMjE4OTMwMzU2NiIsIlBhZ2VOYW1lIjoiIiwiTWFpbCI6IiIsIkNyZWF0ZVRpbWUiOiIyMDI1LTA1LTI3IDE4OjM1OjIzIiwiVG9rZW5UeXBlIjoyLCJpc3MiOiJtaW5pbWF4In0.yUlyEhtMUI4hr61vkd3rtpVFwMI3qxCDrULaU9AnO8-eyS_yk9s778W8mB62kDSCpXU93xZXLkukhGT88WrrbRvwJsd2j2jAz6UsVs5UfTQzcvJhSDgvTm3zQCOwobRezwXaettGQAiWdaJMBhsjf9X79ISGmwk8Md1jVIH8xIAbrHGGcwx5xEriSQGvlqYaPejoK9LjhVuHXVT-lLvU7Qg6saTaQ--pvmai92JqKb8YIUigfy2zLQImm9iv9W-aWn3pO3ddiaapH49ym6zZi6AgeQmGWu1298I2IsBEZvIrbKVt6vBuryFRUuOUQ3H1omM0GMNy0JEEVU8ACvBh-g' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "speech-02-hd",
    "text": "真正的危险不是计算机开始像人一样思考，而是人开始像计算机一样思考。计算机只是可以帮我们处理一些简单事务。",
    "stream": false,
    "voice_setting": {
        "voice_id": "male-qn-qingse",
        "speed": 1,
        "vol": 1,
        "pitch": 0,
        "emotion": "happy"
    },
    "pronunciation_dict": {
        "tone": [
            "处理/(chu3)(li3)",
            "危险/dangerous"
        ]
    },
    "audio_setting": {
        "sample_rate": 32000,
        "bitrate": 128000,
        "format": "mp3",
        "channel": 1
    },
    // "response_format": "url",
}'

返回响应

🟢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"
    }
}