Gunakan API HTTP Voice Design untuk membuat, menampilkan daftar, mengkueri, dan menghapus voice kustom.
Panduan pengguna: Voice Design.
Suara yang dibuat melewati proses peninjauan. Status berikut berlaku untuk Qwen-Audio-TTS/CosyVoice ketika
Endpoint
- China (Beijing)
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customizationGanti {WorkspaceId} dengan workspace ID Anda yang sebenarnya.Header permintaan
Parameter | Type | Wajib | Deskripsi |
|---|---|---|---|
Authorization | string | Ya | Atur ke |
Content-Type | string | Ya | Jenis media badan permintaan. Atur ke |
Membuat voice
Isi permintaanmodelstring(Wajib)Model desain voice. Nilai yang valid:
object(Wajib)Objek parameter input.
Properti action string(Wajib)Jenis operasi.
string(Wajib)Model text-to-speech (TTS) untuk voice tersebut. Harus sesuai dengan model dalam panggilan API TTS, atau sintesis akan gagal.qwen-audio-3.0-tts-plus dan qwen-audio-3.0-tts-flash tidak mendukung Voice Design.voice_prompt string(Wajib)Deskripsi karakteristik voice yang diinginkan. Hanya bahasa Mandarin dan Inggris.
string(Wajib)Teks untuk audio pratinjau.
string(Wajib)Awalan nama voice. Hanya alfanumerik, maksimal 10 karakter. Format nama yang dihasilkan: {target_model}-vd-{prefix}-{unique_id}language_hints array[string](Opsional)Petunjuk bahasa untuk pembuatan voice. Harus sesuai dengan bahasa preview_text.Saat ini, hanya elemen pertama yang digunakan.Nilai yang valid:
object(Opsional)Konfigurasi untuk desain suara.
Properti sample_rate int(Opsional)Laju sampel audio pratinjau, dalam Hz.
string(Opsional)Format audio pratinjau.
| Contoh berikut menggunakan konfigurasi wilayah China (Beijing). Ganti {WorkspaceId} dengan ID workspace Anda yang sebenarnya. |
Isi Responsrequest_idstringPengidentifikasi unik untuk permintaan ini.outputobjectData yang dikembalikan oleh model.
Properti voice_id stringID suara. Gunakan dalam parameter voice pada TTS API.preview_audioobjectData audio pratinjau.
Properti data stringData audio pratinjau yang dienkripsi dalam Base64.sample_rate intLaju sampel audio pratinjau, dalam Hz.response_format stringFormat audio pratinjau.stringModel TTS yang mendasari suara tersebut.objectInformasi penggunaan untuk permintaan ini.
Properti count integerJumlah voice yang dibuat. Selalu 1. |
Daftar suara
Badan permintaanmodelstring(Wajib)Model desain voice. Nilai yang valid:
object(Wajib)Objek parameter input.
Properti action string(Wajib)Tetapkan ke list_voice.prefix string(Opsional)Filter voice berdasarkan awalan nama.page_index integer(Opsional)Indeks halaman.page_size integer(Opsional)Jumlah entri per halaman. | Contoh berikut menggunakan konfigurasi wilayah China (Beijing). Ganti {WorkspaceId} dengan ID workspace Anda yang sebenarnya. |
Badan tanggapanrequest_idstringPengidentifikasi unik untuk permintaan ini.outputobjectData yang dikembalikan oleh model.
Properti voice_list array[object]Daftar voice yang dikembalikan oleh kueri.
Properti voice_id stringID suara. Gunakan dalam parameter voice pada TTS API.gmt_createstringWaktu pembuatan.gmt_modifiedstringWaktu modifikasi terakhir.statusstringStatus voice. Untuk nilai yang valid, lihat "Referensi status voice".voice_promptstringTeks deskripsi voice.preview_textstringTeks audio pratinjau.objectInformasi penggunaan untuk permintaan ini.
Properti count integerSelalu 1. |
Mengkueri detail voice
Isi permintaanmodelstring(Wajib)Model desain voice. Nilai yang valid:
object(Wajib)Objek parameter input.
Properti action string(Wajib)Tetapkan ke query_voice.voice_id string(Wajib)ID voice yang akan dikueri. | Contoh berikut menggunakan konfigurasi wilayah China (Beijing). Ganti {WorkspaceId} dengan ID workspace Anda yang sebenarnya. |
Isi responsrequest_idstringPengidentifikasi unik untuk permintaan ini.outputobjectData yang dikembalikan oleh model.
Properti voice_id stringID suara. Gunakan dalam parameter voice pada TTS API.gmt_createstringWaktu pembuatan.gmt_modifiedstringWaktu modifikasi terakhir.statusstringStatus voice. Untuk nilai yang valid, lihat "Referensi status voice".target_modelstringModel TTS yang menghasilkan suara.voice_promptstringTeks deskripsi voice.preview_textstringTeks audio pratinjau.objectInformasi penggunaan untuk permintaan ini.
Properti count integerSelalu 1. |
Hapus suara
Isi permintaanmodelstring(Wajib)Model desain voice. Nilai yang valid:
object(Wajib)Objek parameter input.
Properti action string(Wajib)Tetapkan ke delete_voice.voice_id string(Wajib)ID voice yang akan dihapus. | Contoh berikut menggunakan konfigurasi wilayah China (Beijing). Ganti {WorkspaceId} dengan ID workspace Anda yang sebenarnya. |
Isi responsrequest_idstringPengidentifikasi unik untuk permintaan ini.outputobjectData yang dikembalikan oleh model. Berupa objek kosong.usageobjectInformasi penggunaan untuk permintaan ini.
Properti count integerSelalu 1. |
Referensi status voice
Suara yang dibuat melewati proses peninjauan. Status berikut berlaku untuk Qwen-Audio-TTS/CosyVoice ketika model adalah voice-enrollment.
Status | Deskripsi |
|---|---|
DEPLOYING | Dalam peninjauan atau pemrosesan. |
OK | Peninjauan lolos. Voice siap digunakan. |
UNDEPLOYED | Peninjauan ditolak. Voice tidak dapat digunakan. |