MiniMax Speech 2.8 HD / Turbo · Referensi API
Ubah teks ke audio, pilih suara dan format, dan baca buffered SSE Jawaban.
Kirim permintaan JSON ke POST /v1/wand/minimax-tts/sync_tts dengan kunci API APIMaster di header Authorization: Bearer. Set model ke minimax-speech-2.8-hd atau minimax-speech-2.8-turbo.
| Kolom | Tipe | Deskripsi |
|---|---|---|
text |
string | Diperlukan, kurang dari 10,000 karakter. Gunakan baris baru untuk paragraf, <#x#> untuk jeda x detik, dan tanda kurung pinyin atau IPA untuk pelafalan. Model dukungan isyarat seperti (laughs). |
voice_setting |
object | Wajib. Atur voice_id ke sistem suara atau ke lengkap referensi dikembalikan oleh desain suara atau kloning suara. Ketika mencampur suara, tinggalkan ID ini kosong dan atur timbre_weights. |
voice_setting.speed, voice_setting.vol, voice_setting.pitch |
number | Kecepatan 0.5–2 (bawaan 1). Volume lebih besar dari 0 dan paling banyak 10 (baku 1). Integer pitch −12 ke 12 (baku 0). |
voice_setting.emotion |
string | happy, sad, angry, fearful, disgusted, surprised, calm, atau fluent. Omit untuk membiarkan model memilih. |
voice_setting.text_normalization, voice_setting.latex_read |
boolean | Keduanya baku untuk false. Bungkus persamaan dalam $$ untuk pembacaan LaTeX. |
audio_setting.sample_rate |
integer | 8000, 16000, 22050, 24000, 32000 (bawaan), atau 44100 Hz. |
audio_setting.bitrate |
integer | MP3 Hanya. 32000, 64000, 128000 (baku), atau 256000Bps. |
audio_setting.format |
string | mp3 (baku), pcm, flac, wav, pcmu_raw, pcmu_wav, atau opus.Z. |
audio_setting.channel |
integer | 1 (bawaan) atau 2. |
pronunciation_dict.tone |
string[] | Entri di original/replacement formulir. Penggantian dapat menggunakan teks, pinyin, IPA, atau Kana Jepang. |
timbre_weights |
object[] | Sampai empat entri dengan voice_id dan weight dari 1 ke 100. |
language_boost |
string | Peningkatan bahasa pilihan. Gunakan auto, sebuah bahasa yang didukung, atau diabaikan. |
voice_modify.pitch, voice_modify.intensity, voice_modify.timbre |
integer | −100 ke 100. |
voice_modify.sound_effects |
string | spacious_echo, auditorium_echo, lofi_telephone, atau robotic. Untuk non-streaming, efek ini bekerja dengan MP3, WAV, dan FLAC. Untuk SSE, gunakan MP3. |
subtitle_enable, subtitle_type |
boolean, string | Sub judul dihapus secara default. Tipenya adalah sentence (bawaan) atau word. |
output_format |
string | hex (bawaan) atau url untuk permintaan non-streaming. URLs pratinjau berlaku selama 24 jam. |
aigc_watermark, stream |
boolean | Keduanya baku untuk false. SSE disangga sampai generasi dan tagihan selesai dan mengirim audio hex. |
language_boost terima 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, dan Afrikaans.
Suara sistem termasuk English_Graceful_Lady, English_Trustworthy_Man, male-qn-qingse, male-qn-jingying, female-shaonv, dan female-yujie. Gunakan suara gubahan yang dikembalikan oleh Voice Design atau Vlice CloneZXZ dari akun yang sama.
curl -X POST "https://apimaster.ai/v1/wand/minimax-tts/sync_tts" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"minimax-speech-2.8-hd","text":"Welcome to the program.","voice_setting":{"voice_id":"English_Graceful_Lady"},"output_format":"url"}'
Dalam respon non-streaming, periksa bahwa base_resp.status_code adalah 0 dan data.status adalah 2. data.audio berisi audio hex-encoded atau berkas subjudul URL, dan data.subtitle_file dapat memuat JSON. extra_info dapat mencakup panjang dalam milidetik, tingkat sampel, ukuran, format, dan usage_characters. Simpan trace_id atau request_id jika Anda membutuhkan bantuan mendiagnosa sebuah kegagalan.
For SSE, data.status=1 adalah segmen dan 2 adalah pelengkapan, berpotensi diikuti oleh [DONE]. Gabung segmen hex dalam rangka dan decode mereka ke byte. Teks dapat berisi ofset karakter, waktu ofset dalam milidetik, dan timestamped_words. Gunakan kumulatif usage.total_tokens atau usage.total_token sekali alih-alih perhitungan kumulatif frame.
Lihat HD dan Turbo model kartu untuk saat ini APIMaster Harga. Inisial sintesis dengan suara adat juga dapat mencakup biaya suara.
