Parameter HTTP, respons, dan contoh kloning suara untuk Qwen-Audio dan CosyVoice.
Referensi ini mencakup Qwen-Audio-TTS, Qwen-Audio-Realtime, dan CosyVoice.
Pertama, dapatkan API Key dan konfigurasikan variabel lingkungan. Contoh permintaan membaca
Ganti
Untuk persyaratan audio, lihat Panduan pengguna kloning suara. Proses kloning Qwen-Audio-Realtime dijelaskan dalam Kloning suara percakapan suara realtime. Pembuatan suara Qwen-Audio-Realtime gratis. Panggilan model ditagih sesuai model tujuan. Lihat detailnya dalam Informasi penagihan dan batas jumlah dalam Informasi kuota.
Suara yang dibuat akan melalui proses peninjauan.
Jika terjadi error, lihat Kode error untuk pemecahan masalah.
DASHSCOPE_API_KEY. Gunakan akun yang sama saat mengelola suara yang sama melalui API berbeda.
Untuk definisi SDK, lihat Java SDK dan Python SDK.
Titik akhir layanan
- Tiongkok (Beijing)
- Singapura
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization{WorkspaceId} dengan ID ruang kerja yang sebenarnya. ID ini tersedia pada halaman Workspace Details di konsol Alibaba Cloud Model Studio. API Key untuk Beijing dan Singapura berbeda.
Header permintaan
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| Authorization | string | Ya | Token otentikasi dalam format Bearer <your_api_key>. Ganti <your_api_key> dengan Kunci API Anda yang sebenarnya. |
| Content-Type | string | Ya | Tetapkan ke application/json. |
Persyaratan audio dan biaya
Untuk persyaratan audio, lihat Panduan pengguna kloning suara. Proses kloning Qwen-Audio-Realtime dijelaskan dalam Kloning suara percakapan suara realtime. Pembuatan suara Qwen-Audio-Realtime gratis. Panggilan model ditagih sesuai model tujuan. Lihat detailnya dalam Informasi penagihan dan batas jumlah dalam Informasi kuota.
Isi permintaan
model string — WajibAtur ke voice-enrollment.input object — Wajib
Properti action string — WajibOperasi:
string — Wajib saat membuatModel yang akan menggunakan suara. Model ini harus sama dengan model pada pemanggilan sintesis atau percakapan berikutnya; jika berbeda, pemanggilan gagal.Pilih model Qwen-Audio-TTS, Qwen-Audio-Realtime, atau CosyVoice yang mendukung kloning suara. Lihat ID model dan wilayah di Model yang didukung.audio string — Wajib saat membuat atau memperbarui jika url tidak diberikanAudio referensi untuk pembuatan, atau audio referensi baru untuk pembaruan. Menerima URL yang dapat diakses publik atau Data URI Base64, seperti data:audio/wav;base64,....Kompatibel dengan parameter lama url. Jika menggunakan url, audio dapat dihilangkan. url akan dihentikan secara bertahap, jadi sebaiknya beralih ke audio.string — Wajib saat membuat; opsional saat mencantumkanSaat membuat: prefiks nama suara. Hanya angka dan huruf Inggris yang diizinkan, maksimal 10 karakter. Nama suara yang dihasilkan berformat {target_model}-{prefix}-{unique_id}.Saat mencantumkan: memfilter suara berdasarkan prefiks nama.language_hints array[string] — Opsional saat membuatMembantu model mengenali bahasa audio sampel agar karakteristik suara diekstrak lebih akurat dan hasil kloning lebih baik. Jika bahasa yang ditentukan tidak sesuai dengan bahasa audio sebenarnya, misalnya en untuk audio bahasa Mandarin, sistem mengabaikan pengaturan ini dan mendeteksi bahasa secara otomatis.Parameter ini berupa array dengan panjang harus 1.Berlaku untuk qwen-audio-3.1-tts-plus, qwen-audio-3.1-tts-flash, qwen-audio-3.0-tts-plus, qwen-audio-3.0-tts-flash, qwen-audio-3.1-realtime-plus, qwen-audio-3.1-realtime-flash, qwen-audio-3.0-realtime-plus, qwen-audio-3.0-realtime-flash, cosyvoice-v3.5-plus, cosyvoice-v3.5-flash, cosyvoice-v3-plus, cosyvoice-v3-flash.
Klik untuk melihat bahasa yang didukung setiap model
float — Opsional saat membuatDurasi maksimum (detik) audio referensi untuk kloning suara setelah prapemrosesan. Rentang nilai: [3.0, 30.0].Nilai default: 10.0.Berlaku untuk qwen-audio-3.1-tts-plus, qwen-audio-3.1-tts-flash, qwen-audio-3.0-tts-plus, qwen-audio-3.0-tts-flash, qwen-audio-3.1-realtime-plus, qwen-audio-3.1-realtime-flash, qwen-audio-3.0-realtime-plus, qwen-audio-3.0-realtime-flash, cosyvoice-v3.5-plus, cosyvoice-v3.5-flash, cosyvoice-v3-flash. boolean — Opsional saat membuatApakah prapemrosesan audio (pengurangan derau, peningkatan audio, dan normalisasi volume) diaktifkan. Aktifkan untuk rekaman dengan derau latar. Nonaktifkan untuk rekaman di lingkungan tenang agar karakteristik suara asli tetap terjaga.Default: false.Berlaku untuk qwen-audio-3.1-tts-plus, qwen-audio-3.1-tts-flash, qwen-audio-3.0-tts-plus, qwen-audio-3.0-tts-flash, qwen-audio-3.1-realtime-plus, qwen-audio-3.1-realtime-flash, qwen-audio-3.0-realtime-plus, qwen-audio-3.0-realtime-flash, cosyvoice-v3.5-plus, cosyvoice-v3.5-flash, cosyvoice-v3-flash. string — Opsional saat membuatApakah volume audio sampel untuk kloning suara dinormalisasi. Nilai:
"false".page_index integer — Opsional saat mencantumkanIndeks halaman.page_size integer — Opsional saat mencantumkanJumlah entri per halaman.voice_id string — Wajib untuk melihat, memperbarui, atau menghapusID suara yang akan dilihat, diperbarui, atau dihapus. | Contoh permintaan
Contoh ini menggunakan qwen-audio-3.1-tts-plus. Ganti target_model di dalam input dengan ID model target Anda yang sebenarnya.Konfigurasi berikut untuk region Singapura. Ganti "{WorkspaceId}" dengan ID ruang kerja yang sebenarnya. Konfigurasi berbeda menurut region.audio pada bidang audio objek input dalam permintaan pembuatan atau pembaruan. Ganti sample.wav dengan jalur file audio lokal. |
Isi respons
request_id stringPengidentifikasi unik permintaan ini.output objectBerisi bidang untuk pembuatan, pencantuman, atau pengambilan detail suara. Pembaruan tidak mengembalikan data bisnis. Respons dapat menyertakan bidang preview_audio berupa objek kosong yang dapat diabaikan. Penghapusan mengembalikan objek kosong.
Properti voice_id string — Dikembalikan saat membuatID suara.voice_list array[object] — Dikembalikan saat mencantumkanDaftar suara yang ditemukan.
Properti voice_id stringID suara.target_model stringModel tujuan yang menggunakan suara (teks ke ucapan atau percakapan suara realtime).gmt_create stringWaktu pembuatan suara.gmt_modified stringWaktu perubahan terakhir.status stringStatus suara. Untuk nilai yang valid, lihat “Deskripsi status suara”.string — Dikembalikan untuk detail suaraURL file audio.gmt_create string — Dikembalikan untuk detail suaraWaktu pembuatan suara.gmt_modified string — Dikembalikan untuk detail suaraWaktu perubahan terakhir.status string — Dikembalikan untuk detail suaraStatus suara. Untuk nilai yang valid, lihat “Deskripsi status suara”.target_model string — Dikembalikan untuk detail suaraModel tujuan yang menggunakan suara (teks ke ucapan atau percakapan suara realtime).objectInformasi penggunaan untuk permintaan ini.
Properti count integerSelalu 1. Untuk pembuatan suara, ini menunjukkan jumlah suara yang dibuat. | Contoh respons
|
Deskripsi status suara
Suara yang dibuat akan melalui proses peninjauan.
| Status | Deskripsi |
|---|---|
| DEPLOYING | Sedang dalam peninjauan atau pemrosesan. |
| OK | Peninjauan berhasil. Suara siap digunakan. |
| UNDEPLOYED | Peninjauan ditolak. Suara tidak dapat digunakan. |