model string — 必選 固定為 qwen-voice-enrollment。 input object — 必選 屬性 action string — 必選 操作類型:
create: 建立音色。
list: 查詢音色列表(僅 Qwen-Omni、Qwen-Omni-Realtime)。
delete: 刪除音色。
target_model string — 建立時必選 後續使用音色的目標模型。必須與後續呼叫時使用的模型一致,否則呼叫失敗。 Qwen-Omni、Qwen-Omni-Realtime:驅動音色的全模態模型:
- qwen3.8-omni-flash-realtime
- qwen3.5-omni-plus-realtime
- qwen3.5-omni-flash-realtime
- qwen3.5-omni-plus
- qwen3.5-omni-flash
audio object — 建立時必選 參考音訊對象。 屬性 data string — 必選 Qwen-Omni、Qwen-Omni-Realtime:用於複刻的音訊(錄制時需遵循錄音操作指南,音訊需滿足音訊要求)。 Qwen-Omni、Qwen-Omni-Realtime 可透過以下兩種方式提交音訊資料:
-
Data URL
格式:data:<mediatype>;base64,<data>
-
<mediatype>:MIME類型
- WAV:
audio/wav
- MP3:
audio/mpeg
- M4A:
audio/mp4
-
<data>:音訊轉成的Base64編碼的字串
Base64編碼會增大體積,請控制原文件大小,確保編碼後仍小於10MB
-
示例:data:audio/wav;base64,SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU4LjI5LjEwMAAAAAAAAAAAAAAA//PAxABQ/BXRbMPe4IQAhl9
-
音訊URL(推薦將音訊上傳至OSS)
- 文件大小不超過10MB
- URL必須公網可訪問且無需鑒權
Qwen-LiveTranslate-Realtime:參考音訊的公網 URL。 preferred_name string — 建立時必選 Qwen-Omni、Qwen-Omni-Realtime:為音色指定一個便於識別的名稱(僅允許數字、大小寫字母和底線,不超過16個字元)。
該關鍵字會在複刻的音色名中出現,例如關鍵字為“guanyu”,最終音色名為“qwen-omni-vc-guanyu-voice-20250812105009984-838b”
Qwen-LiveTranslate-Realtime:音色名稱中的標識。 text string — 建立時可選 適用於 Qwen-Omni、Qwen-Omni-Realtime。 與audio 對象中的 data音訊內容相匹配的文本。 傳入該參數後,服務端會對比音訊與該文本的差異,若差異過大,将返回Audio.PreprocessError。 language string — 建立時可選 適用於 Qwen-Omni、Qwen-Omni-Realtime。 audio 對象中的 data音訊對應的語種。
支援zh(中文)、en(英文)、de(德語)、it(意大利語)、pt(葡萄牙語)、es(西班牙語)、ja(日語)、ko(韓語)、fr(法語)、ru(俄語)、th(泰語)、id(印尼語)、ar(阿拉伯語)、cs(捷克語)、da(丹麥語)、nl(荷蘭語)、fi(芬蘭語)、he(希伯來語)、hi(印地語)、is(冰島語)、ms(馬來語)、no(挪威語)、fa(波斯語)、pl(波蘭語)、sv(瑞典語)、tl(他加祿語)、tr(土耳其語)、ur(烏爾都語)、vi(越南語)。 中文方言:Dongbei(東北話)、Shannxi(陝西話)、Sichuan(四川話)、Henan(河南話)、Changsha(長沙話)、Tianjin(天津話)、Hangzhou(杭州話)、Liaoning(遼寧話)、Shenyang(瀋陽話)、Anshan(鞍山話)。 若使用該參數,設置的語種要和實際用於複刻的音訊的語種一致。 page_index integer — 查詢列表時可選 頁碼索引。 預設值為 0,取值範圍:[0, 1000000]。 page_size integer — 查詢列表時可選 每頁包含資料條數。 預設值為 10,取值範圍:[0, 1000000]。 voice string — 刪除時必選 待刪除的複刻音色或預建音色 ID。 Qwen-Omni、Qwen-Omni-Realtime 刪除音色後會釋放對應的音色額度。 parameters object — 建立時條件必選 適用於 Qwen-Omni、Qwen-Omni-Realtime。 設定參數物件。使用 qwen3.8-omni 系列模型時,須透過此物件傳入 voice_clone_mode。 屬性 voice_clone_mode string — 條件必選 聲音複刻模式。使用qwen3.8-omni系列模型時必傳,不傳時預設回退到qwen3.5-omni talker system instruct模式(兼容舊服務)。 可選值:
normal:普通模式
dialect:方言模式
crosslingual:跨語言模式
skip_audio_process boolean — 可選 預設值:false。 是否跳過音訊前處理。 | 請求示例建立qwen3.8-omni-flash-realtimecURL 示例使用音訊 URL,請將 https://xxx.wav 替換為實際地址。Python 和 Java 示例讀取本地音訊,請將 input.mp3 替換為實際文件路徑。 # 未配置环境变量时,将下方 $DASHSCOPE_API_KEY 替换为实际 API Key。
# ======= 重要提示 =======
# 以下为新加坡地域URL,调用时请将{WorkspaceId}替换为真实的业务空间ID,各地域的URL不同。
# 新加坡地域和北京地域的API Key不同。获取API Key:https://www.alibabacloud.com/help/model-studio/get-api-key
# === 执行时请删除该注释 ===
curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-voice-enrollment",
"parameters": {"voice_clone_mode": "normal"},
"input": {
"action": "create",
"target_model": "qwen3.8-omni-flash-realtime",
"preferred_name": "guanyu",
"audio": {
"data": "https://xxx.wav"
}
}
}'
import os
import requests
import base64, pathlib
target_model = "qwen3.8-omni-flash-realtime"
preferred_name = "guanyu"
audio_mime_type = "audio/mpeg"
file_path = pathlib.Path("input.mp3")
base64_str = base64.b64encode(file_path.read_bytes()).decode()
data_uri = f"data:{audio_mime_type};base64,{base64_str}"
# 新加坡地域和北京地域的API Key不同。获取API Key:https://www.alibabacloud.com/help/model-studio/get-api-key
# 若没有配置环境变量,请用百炼API Key将下行替换为:api_key = "sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")
# 以下为新加坡地域URL,调用时请将{WorkspaceId}替换为真实的业务空间ID,各地域的URL不同。
url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization"
payload = {
"model": "qwen-voice-enrollment", # 不要修改这个值
"parameters": {"voice_clone_mode": "normal"},
"input": {
"action": "create",
"target_model": target_model,
"preferred_name": preferred_name,
"audio": {
"data": data_uri
}
}
}
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
# 发送 POST 请求
resp = requests.post(url, json=payload, headers=headers)
if resp.status_code == 200:
data = resp.json()
voice = data["output"]["voice"]
print(f"生成的 voice 参数为: {voice}")
else:
print("请求失败:", resp.status_code, resp.text)
import com.google.gson.Gson;
import com.google.gson.JsonObject;
import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.file.*;
import java.util.Base64;
public class Main {
private static final String TARGET_MODEL = "qwen3.8-omni-flash-realtime";
private static final String PREFERRED_NAME = "guanyu";
private static final String AUDIO_FILE = "input.mp3";
private static final String AUDIO_MIME_TYPE = "audio/mpeg";
public static String toDataUrl(String filePath) throws Exception {
byte[] bytes = Files.readAllBytes(Paths.get(filePath));
String encoded = Base64.getEncoder().encodeToString(bytes);
return "data:" + AUDIO_MIME_TYPE + ";base64," + encoded;
}
public static void main(String[] args) {
// 新加坡地域和北京地域的API Key不同。获取API Key:https://www.alibabacloud.com/help/model-studio/get-api-key
// 若没有配置环境变量,请用百炼API Key将下行替换为:String apiKey = "sk-xxx";
String apiKey = System.getenv("DASHSCOPE_API_KEY");
// 以下为新加坡地域URL,调用时请将{WorkspaceId}替换为真实的业务空间ID,各地域的URL不同。
String apiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization";
try {
// 构造 JSON 请求体(注意内部的引号需转义)
String jsonPayload =
"{"
+ "\"model\": \"qwen-voice-enrollment\"," // 不要修改该值
+ "\"parameters\": {\"voice_clone_mode\": \"normal\"},"
+ "\"input\": {"
+ "\"action\": \"create\","
+ "\"target_model\": \"" + TARGET_MODEL + "\","
+ "\"preferred_name\": \"" + PREFERRED_NAME + "\","
+ "\"audio\": {"
+ "\"data\": \"" + toDataUrl(AUDIO_FILE) + "\""
+ "}"
+ "}"
+ "}";
HttpURLConnection con = (HttpURLConnection) new URL(apiUrl).openConnection();
con.setRequestMethod("POST");
con.setRequestProperty("Authorization", "Bearer " + apiKey);
con.setRequestProperty("Content-Type", "application/json");
con.setDoOutput(true);
// 发送请求体
try (OutputStream os = con.getOutputStream()) {
os.write(jsonPayload.getBytes("UTF-8"));
}
int status = con.getResponseCode();
InputStream is = (status >= 200 && status < 300)
? con.getInputStream()
: con.getErrorStream();
StringBuilder response = new StringBuilder();
try (BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8"))) {
String line;
while ((line = br.readLine()) != null) {
response.append(line);
}
}
System.out.println("HTTP 状态码: " + status);
System.out.println("返回内容: " + response.toString());
if (status == 200) {
// 解析 JSON
Gson gson = new Gson();
JsonObject jsonObj = gson.fromJson(response.toString(), JsonObject.class);
String voice = jsonObj.getAsJsonObject("output").get("voice").getAsString();
System.out.println("生成的 voice 参数为: " + voice);
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
qwen3.8-livetranslate-flash-realtimePOST https://dashscope.aliyuncs.com/api/v1/services/audio/tts/customization
Authorization: Bearer <your_api_key>
Content-Type: application/json
curl -X POST 'https://dashscope.aliyuncs.com/api/v1/services/audio/tts/customization' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "qwen-voice-enrollment",
"input": {
"action": "create",
"target_model": "qwen3.8-livetranslate-flash-realtime",
"preferred_name": "tmtest381103",
"audio": {
"data": "https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/cosyvoice/cosyvoice-zeroshot-sample.wav"
}
}
}'
查詢列表Qwen-Omni# 未配置环境变量时,将下方 $DASHSCOPE_API_KEY 替换为实际 API Key。
# ======= 重要提示 =======
# 以下为新加坡地域URL,调用时请将{WorkspaceId}替换为真实的业务空间ID,各地域的URL不同。
# 新加坡地域和北京地域的API Key不同。获取API Key:https://www.alibabacloud.com/help/model-studio/get-api-key
# === 执行时请删除该注释 ===
curl --location --request POST 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "qwen-voice-enrollment",
"input": {
"action": "list",
"page_size": 10,
"page_index": 0
}
}'
import os
import requests
# 新加坡地域和北京地域的API Key不同。获取API Key:https://www.alibabacloud.com/help/model-studio/get-api-key
# 若没有配置环境变量,请用百炼API Key将下行替换为:api_key = "sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")
# 以下为新加坡地域URL,调用时请将{WorkspaceId}替换为真实的业务空间ID,各地域的URL不同。
url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization"
payload = {
"model": "qwen-voice-enrollment", # 不要修改该值
"input": {
"action": "list",
"page_size": 10,
"page_index": 0
}
}
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print("HTTP 状态码:", response.status_code)
if response.status_code == 200:
data = response.json()
voice_list = data["output"]["voice_list"]
print("查询到的音色列表:")
for item in voice_list:
print(f"- 音色: {item['voice']} 创建时间: {item['gmt_create']} 模型: {item['target_model']}")
else:
print("请求失败:", response.text)
import com.google.gson.Gson;
import com.google.gson.JsonArray;
import com.google.gson.JsonObject;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
public class Main {
public static void main(String[] args) {
// 新加坡地域和北京地域的API Key不同。获取API Key:https://www.alibabacloud.com/help/model-studio/get-api-key
// 若没有配置环境变量,请用百炼API Key将下行替换为:String apiKey = "sk-xxx";
String apiKey = System.getenv("DASHSCOPE_API_KEY");
// 以下为新加坡地域URL,调用时请将{WorkspaceId}替换为真实的业务空间ID,各地域的URL不同。
String apiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization";
// JSON 请求体(旧版本 Java 无 """ 多行字符串)
String jsonPayload =
"{"
+ "\"model\": \"qwen-voice-enrollment\"," // 不要修改该值
+ "\"input\": {"
+ "\"action\": \"list\","
+ "\"page_size\": 10,"
+ "\"page_index\": 0"
+ "}"
+ "}";
try {
HttpURLConnection con = (HttpURLConnection) new URL(apiUrl).openConnection();
con.setRequestMethod("POST");
con.setRequestProperty("Authorization", "Bearer " + apiKey);
con.setRequestProperty("Content-Type", "application/json");
con.setDoOutput(true);
try (OutputStream os = con.getOutputStream()) {
os.write(jsonPayload.getBytes("UTF-8"));
}
int status = con.getResponseCode();
BufferedReader br = new BufferedReader(new InputStreamReader(
status >= 200 && status < 300 ? con.getInputStream() : con.getErrorStream(), "UTF-8"));
StringBuilder response = new StringBuilder();
String line;
while ((line = br.readLine()) != null) {
response.append(line);
}
br.close();
System.out.println("HTTP 状态码: " + status);
System.out.println("返回 JSON: " + response.toString());
if (status == 200) {
Gson gson = new Gson();
JsonObject jsonObj = gson.fromJson(response.toString(), JsonObject.class);
JsonArray voiceList = jsonObj.getAsJsonObject("output").getAsJsonArray("voice_list");
System.out.println("\n 查询到的音色列表:");
for (int i = 0; i < voiceList.size(); i++) {
JsonObject voiceItem = voiceList.get(i).getAsJsonObject();
String voice = voiceItem.get("voice").getAsString();
String gmtCreate = voiceItem.get("gmt_create").getAsString();
String targetModel = voiceItem.get("target_model").getAsString();
System.out.printf("- 音色: %s 创建时间: %s 模型: %s\n",
voice, gmtCreate, targetModel);
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
刪除Qwen-Omni將 yourVoice 替換為要刪除的音色名稱。 # 未配置环境变量时,将下方 $DASHSCOPE_API_KEY 替换为实际 API Key。
# ======= 重要提示 =======
# 以下为新加坡地域URL,调用时请将{WorkspaceId}替换为真实的业务空间ID,各地域的URL不同。
# 新加坡地域和北京地域的API Key不同。获取API Key:https://www.alibabacloud.com/help/model-studio/get-api-key
# === 执行时请删除该注释 ===
curl --location --request POST 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "qwen-voice-enrollment",
"input": {
"action": "delete",
"voice": "yourVoice"
}
}'
import os
import requests
# 新加坡地域和北京地域的API Key不同。获取API Key:https://www.alibabacloud.com/help/model-studio/get-api-key
# 若没有配置环境变量,请用百炼API Key将下行替换为:api_key = "sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")
# 以下为新加坡地域URL,调用时请将{WorkspaceId}替换为真实的业务空间ID,各地域的URL不同。
url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization"
voice_to_delete = "yourVoice" # 要删除的音色(替换为真实值)
payload = {
"model": "qwen-voice-enrollment", # 不要修改该值
"input": {
"action": "delete",
"voice": voice_to_delete
}
}
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print("HTTP 状态码:", response.status_code)
if response.status_code == 200:
data = response.json()
request_id = data["request_id"]
print(f"删除成功")
print(f"Request ID: {request_id}")
else:
print("请求失败:", response.text)
import com.google.gson.Gson;
import com.google.gson.JsonObject;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
public class Main {
public static void main(String[] args) {
// 新加坡地域和北京地域的API Key不同。获取API Key:https://www.alibabacloud.com/help/model-studio/get-api-key
// 若没有配置环境变量,请用百炼API Key将下行替换为:String apiKey = "sk-xxx";
String apiKey = System.getenv("DASHSCOPE_API_KEY");
// 以下为新加坡地域URL,调用时请将{WorkspaceId}替换为真实的业务空间ID,各地域的URL不同。
String apiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization";
String voiceToDelete = "yourVoice"; // 要删除的音色(替换为真实值)
// 构造 JSON 请求体(字符串拼接,兼容 Java 8)
String jsonPayload =
"{"
+ "\"model\": \"qwen-voice-enrollment\"," // 不要修改该值
+ "\"input\": {"
+ "\"action\": \"delete\","
+ "\"voice\": \"" + voiceToDelete + "\""
+ "}"
+ "}";
try {
// 建立 POST 连接
HttpURLConnection con = (HttpURLConnection) new URL(apiUrl).openConnection();
con.setRequestMethod("POST");
con.setRequestProperty("Authorization", "Bearer " + apiKey);
con.setRequestProperty("Content-Type", "application/json");
con.setDoOutput(true);
// 发送请求体
try (OutputStream os = con.getOutputStream()) {
os.write(jsonPayload.getBytes("UTF-8"));
}
int status = con.getResponseCode();
BufferedReader br = new BufferedReader(new InputStreamReader(
status >= 200 && status < 300 ? con.getInputStream() : con.getErrorStream(), "UTF-8"));
StringBuilder response = new StringBuilder();
String line;
while ((line = br.readLine()) != null) {
response.append(line);
}
br.close();
System.out.println("HTTP 状态码: " + status);
System.out.println("返回 JSON: " + response.toString());
if (status == 200) {
Gson gson = new Gson();
JsonObject jsonObj = gson.fromJson(response.toString(), JsonObject.class);
String requestId = jsonObj.get("request_id").getAsString();
System.out.println("删除成功");
System.out.println("Request ID: " + requestId);
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
LiveTranslatecurl -X POST 'https://dashscope.aliyuncs.com/api/v1/services/audio/tts/customization' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "qwen-voice-enrollment",
"input": {"action": "delete", "voice": "VOICE_ID"}
}'
|