Qwen-Audio、CosyVoice 聲音複刻的 HTTP 介面參數、傳回欄位和呼叫示例。
本文適用於 Qwen-Audio-TTS、Qwen-Audio-Realtime、CosyVoice。
先獲取 API Key並配置環境變量。請求示例讀取 DASHSCOPE_API_KEY。使用不同 API 管理同一音色時,請使用同一賬號。
SDK 定義另見 Java SDK 和 Python SDK。
介面地址
華北2(北京)
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization
新加坡
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization
將 {WorkspaceId} 替換為真實的Workspace ID,可在百鍊控制台的业务空间详情頁面查看。北京和新加坡的 API Key 不同。
重要阿里雲百鍊為華北2(北京)、新加坡地域推出了業務空間專屬域名,能夠為推理請求提供卓越的性能和更高的穩定性,建議遷移至新域名:
- 華北2(北京)地域:從
dashscope.aliyuncs.com遷移至{WorkspaceId}.cn-beijing.maas.aliyuncs.com。 - 新加坡地域:從
dashscope-intl.aliyuncs.com遷移至{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com。
現有域名仍可正常使用。
請求頭
| 參數 | 類型 | 是否必選 | 說明 |
|---|---|---|---|
Authorization | string | 是 | 鑒權令牌,格式為 |
Content-Type | string | 是 | 固定為 |
音訊要求與費用
參考音訊要求見聲音複刻用戶指南。Qwen-Audio-Realtime 的複刻流程見即時語音對話音色複刻。Qwen-Audio-Realtime 建立音色免費,模型呼叫按目標模型計費,詳情見計費說明,數量限制見配額說明。
請求體
model 固定為 input | 請求示例建立示例使用 以下為新加坡地域的配置,呼叫時請將"{WorkspaceId}"替換為真實的業務空間ID,各地域的配置不同。 使用本地 WAV 音訊時,可透過以下代碼生成 Base64 Data URI,並將 查詢列表以下為新加坡地域的配置,呼叫時請將"{WorkspaceId}"替換為真實的業務空間ID,各地域的配置不同。 查詢詳情以下為新加坡地域的配置,呼叫時請將"{WorkspaceId}"替換為真實的業務空間ID,各地域的配置不同。 更新以下為新加坡地域的配置,呼叫時請將"{WorkspaceId}"替換為真實的業務空間ID,各地域的配置不同。 刪除以下為新加坡地域的配置,呼叫時請將"{WorkspaceId}"替換為真實的業務空間ID,各地域的配置不同。 |
傳回體
request_id 本次呼叫的唯一標識符。 output 建立、查詢列表或查詢詳情時傳回相應欄位;更新或刪除時傳回空物件。 屬性 voice_id 音色 ID。 voice_list 查詢到的音色列表。 屬性 voice_id 音色 ID。 target_model 驅動音色的目標模型(語音合成或即時語音對話)。 gmt_create 建立時間。 gmt_modified 修改時間。 status 音色狀態,取值參見"音色狀態說明"。 resource_link 音訊文件的URL地址。 gmt_create 建立時間。 gmt_modified 修改時間。 status 音色狀態,取值參見"音色狀態說明"。 target_model 驅動音色的目標模型(語音合成或即時語音對話)。 usage 本次請求用量資訊。 屬性 count 固定為 1。建立音色時,表示建立的音色數量。 | 響應示例建立查詢列表查詢詳情更新刪除 |
音色狀態說明
音色建立後會經過審核流程。
| 狀態 | 說明 |
|---|---|
DEPLOYING | 審核中/處理中。 |
OK | 審核透過,可正常使用。 |
UNDEPLOYED | 審核未透過,不可使用。 |
錯誤資訊
如遇報錯問題,請參見錯誤碼進行排查。