通過自然語言描述建立自訂音色,試聽預覽後用於語音合成。
音色設計適用於快速原型驗證、創意內容生產、遊戲角色配音等情境。
說明建立音色無需提供音頻樣本。如需根據已有音頻樣本還原其聲音,請使用音色複刻。
準備工作
在主控台取得 API Key,並設定 DASHSCOPE_API_KEY 環境變數。
安裝 DashScope SDK 和 requests:
pip install -U dashscope requests
開始使用
Qwen-Audio-TTS 和 CosyVoice 使用相同的音色建立、預覽和基礎合成流程。以下以 qwen-audio-3.1-tts-flash 為例。
- 建立音色:設定聲音描述
voice_prompt、預覽文本preview_text和目標模型target_model,取得音色 ID。 - 儲存預覽音頻:解碼返回的
preview_audio.data,儲存為 WAV 檔案,用於試聽。 - 合成語音:將建立音色時返回的
voice_id作為voice,使用綁定模型合成語音。
import base64
import os
import dashscope
# 以下為華北2(北京)地區的配置,調用時請將"{WorkspaceId}"替換為真實的業務空間ID,各地區的配置不同。
client = dashscope.Client(
# 若沒有將API Key配置到環境變數中,請將下行替換為自己的API Key:api_key="sk-xxx"
api_key=os.getenv("DASHSCOPE_API_KEY"),
workspace="{WorkspaceId}",
region="cn-beijing",
)
target_model = "qwen-audio-3.1-tts-flash"
# 创建音色,并将返回的预览音频保存到本地。
designed = client.audio.voice_design.create(
target_model=target_model,
voice_prompt="沉稳的中年男性播音员,音色低沉浑厚,富有磁性,语速平稳,吐字清晰,适合用于新闻播报或纪录片解说。",
preview_text="各位听众朋友,大家好,欢迎收听晚间新闻。",
preferred_name="announcer",
language="zh",
parameters={"sample_rate": 24000, "response_format": "wav"},
)
voice_id = designed.voice
print(f"voice_id: {voice_id}")
with open("preview.wav", "wb") as f:
f.write(base64.b64decode(designed.preview_audio["data"]))
# 使用创建音色时指定的模型和返回的音色 ID 合成语音。
audio = client.audio.tts.synthesize(
"今天天气晴朗,适合外出散步。祝你度过愉快的一天。",
model=target_model,
voice=voice_id,
format="wav",
sample_rate=24000,
)
with open("output.wav", "wb") as f:
f.write(audio)
執行範例後,preview.wav 為預覽音頻,output.wav 為合成音頻。儲存輸出的音色 ID,後續可使用該 ID 調用語音合成。
HTTP 請求範例、可選參數和返回欄位請參見音色設計 API 參考;合成參數請參見 Qwen-Audio-TTS Python SDK。
聲音描述指南
聲音描述(voice_prompt)用於指定期望的聲音特質。清晰、具體的描述有助於產生符合需求的音色。
描述建議
- 具體:使用「低沉」「清脆」「語速偏快」等聲音特徵,避免「好聽」「普通」等模糊評價。
- 多維:組合性別、年齡、音調、語速和情感等維度,僅寫「女聲」難以描述出有特色的聲音。
- 客觀:描述可感知的聲音特徵,例如「音調偏高、充滿活力」,避免「我最喜歡的聲音」等主觀表達。
- 原創:描述聲音特質,不要求模仿名人、演員等特定人物。模型不支援指定模仿,相關請求也可能涉及著作權風險。
- 簡潔:減少重複的同義詞和無意義的修飾。
可組合以下維度編寫聲音描述:
| 維度 | 描述樣本 |
|---|---|
性別 | 男性、女性、中性 |
年齡 | 兒童 (5-12 歲)、青少年 (13-18 歲)、青年 (19-35 歲)、中年 (36-55 歲)、老年 (55 歲以上) |
音調 | 高音、中音、低音、偏高、偏低 |
語速 | 快速、中速、緩慢、偏快、偏慢 |
情感 | 開朗、沉穩、溫柔、嚴肅、活潑、冷靜、治癒 |
特點 | 有磁性、清脆、沙啞、圓潤、甜美、渾厚、有力 |
用途 | 新聞播報、廣告配音、有聲書、動畫角色、語音助手、紀錄片解說 |
描述範例
- 標準播音風格:吐字清晰精準,字正腔圓
- 年輕活潑的女性聲音,語速較快,帶有明顯的上揚語調,適合介紹時尚產品
- 沉穩的中年男性,語速緩慢,音色低沉有磁性,適合朗讀新聞或紀錄片解說
- 溫柔知性的女性,30 歲左右,語調平和,適合有聲書朗讀
- 可愛的兒童聲音,大約 8 歲女孩,說話略帶稚氣,適合動畫角色配音
說明相同描述可能產生不同的音色。建立後先試聽預覽音頻;需要比較效果時,可多次產生後擇優使用。
音色管理
- 查詢音色列表:查看已有的自訂音色。
- 查詢音色詳情:查看音色綁定的模型、狀態等資訊。
- 刪除音色:刪除不再使用的音色,釋放配額。
介面與參數說明請參見音色設計 API 參考。
支援模型
華北2(北京)
-
Qwen-Audio-TTS:qwen-audio-3.1-tts-plus、qwen-audio-3.1-tts-flash、qwen-audio-3.0-tts-plus、qwen-audio-3.0-tts-flash
-
CosyVoice:cosyvoice-v3.5-plus、cosyvoice-v3.5-flash、cosyvoice-v3-plus、cosyvoice-v3-flash
說明CosyVoice 音色設計基於 FunAudioGen-VD 模型能力。
配額與限制
-
音色數量:每個阿里雲百煉帳號的自訂音色總數上限為 1000 個。音色複刻和音色設計共用該配額,不按模型分別計算。
說明達到上限後,新的音色複刻或音色設計建立請求將失敗。需先刪除不再使用的音色,釋放配額後再建立。
-
聲音描述:
voice_prompt僅支援中文和英文,最大長度為 500 個字元。 -
預覽文本:
preview_text僅支援中文和英文,長度為 15~200 個字元。 -
模型綁定:音色在建立時通過
target_model綁定到語音合成模型,後續合成必須使用同一模型。
產生的音色可用於合成多種語言的語音,具體支援範圍以目標語音合成模型為準。
計費說明
建立音色免費。
使用設計音色合成語音時,按目標語音合成模型計費。具體費用請參見模型計費。