全部產品
Search
文件中心

Alibaba Cloud Model Studio:聲音複刻 HTTP API:Qwen-Omni 與 LiveTranslate

更新時間:Nov 10, 2026

Qwen-Omni 音色建立、查詢列表與刪除,以及 LiveTranslate 預建音色建立與刪除的 HTTP 參數、傳回欄位和示例。

本文適用於 Qwen-Omni、Qwen-Omni-Realtime 和 Qwen-LiveTranslate-Realtime 的 qwen-voice-enrollment 介面。

目標模型本文提供的操作
Qwen-Omni、Qwen-Omni-Realtime建立音色、查詢音色列表、刪除音色
Qwen-LiveTranslate-Realtime建立預建音色、刪除預建音色

先獲取 API Key並配置環境變量。請求示例讀取 DASHSCOPE_API_KEY。使用不同 API 管理同一音色時,請使用同一賬號。

介面地址

Qwen-Omni、Qwen-Omni-Realtime

華北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。

現有域名仍可正常使用。

Qwen-LiveTranslate-Realtime

華北2(北京)地域:

POST https://dashscope.aliyuncs.com/api/v1/services/audio/tts/customization

請求頭

參數類型是否必選說明

Authorization

string

是

鑒權令牌,格式為Bearer <your_api_key>,使用時,將"<your_api_key>"替換為實際的API Key。

Content-Type

string

是

固定為 application/json。

音訊要求與費用

Qwen-Omni、Qwen-Omni-Realtime:輸入音訊支援 WAV(16bit)、MP3、M4A,推薦 10~20 秒,最長 60 秒,文件小於 10 MB,採樣率不低於 24 kHz,且為單聲道。音訊必須包含至少 3 秒連續清晰朗讀,停頓不超過 2 秒;整段音訊應避免背景音樂、噪音或其他人聲。請使用正常說話音訊,不要上傳歌曲或唱歌音訊。支援的語種與方言見下方 language 參數;錄制建議見音訊要求。

複刻步驟、完整示例與費用見聲音複刻用戶指南。

Qwen-LiveTranslate-Realtime:支援 qwen3.8-livetranslate-flash-realtime 和 qwen3.5-livetranslate-flash-realtime。本節介紹提前建立音色;翻譯過程中即時提取輸入音色的方式見音色配置。提前建立音色另行計費,模型呼叫仍按 Token 用量計費,見計費說明。參考音訊使用公網可訪問的 URL。

請求體

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 可透過以下兩種方式提交音訊資料:

  1. 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

  2. 音訊URL(推薦將音訊上傳至OSS)

    • 文件大小不超過10MB
    • URL必須公網可訪問且無需鑒權

Data URL 編碼示例

import base64, pathlib

# input.mp3为用于声音复刻的本地音频文件,请替换为自己的音频文件路径,确保其符合音频要求
file_path = pathlib.Path("input.mp3")
base64_str = base64.b64encode(file_path.read_bytes()).decode()
data_uri = f"data:audio/mpeg;base64,{base64_str}"
import java.nio.file.*;
import java.util.Base64;

public class Main {
    /**
     * filePath为用于声音复刻的本地音频文件,请替换为自己的音频文件路径,确保其符合音频要求
     */
    public static String toDataUrl(String filePath) throws Exception {
        byte[] bytes = Files.readAllBytes(Paths.get(filePath));
        String encoded = Base64.getEncoder().encodeToString(bytes);
        return "data:audio/mpeg;base64," + encoded;
    }

    // 使用示例
    public static void main(String[] args) throws Exception {
        System.out.println(toDataUrl("input.mp3"));
    }
}

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-realtime

cURL 示例使用音訊 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-realtime

POST 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();
        }
    }
}

LiveTranslate

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": "delete", "voice": "VOICE_ID"}
  }'

傳回體

request_id string

本次呼叫的唯一標識符。

output object

建立和查詢列表時傳回;刪除時無此欄位。

屬性

voice string — 建立時傳回

Qwen-Omni、Qwen-Omni-Realtime:音色名稱,可用於後續 Omni 介面的 voice 參數。

Qwen-LiveTranslate-Realtime:建立的音色 ID,在後續翻譯會話的 voice 中使用。

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

必須與後續呼叫全模態介面時使用的模型一致,否則合成會失敗。

Qwen-LiveTranslate-Realtime:建立音色時指定的目標模型。

voice_list array[object] — 查詢列表時傳回

查詢到的音色列表。

屬性

gmt_create string

建立時間。

voice string

音色名稱,可用於後續 Omni 介面的 voice 參數。

target_model string

驅動音色的全模態模型:

  • qwen3.8-omni-flash-realtime

  • qwen3.5-omni-plus-realtime

  • qwen3.5-omni-flash-realtime

  • qwen3.5-omni-plus

  • qwen3.5-omni-flash

必須與後續呼叫全模態介面時使用的模型一致,否則合成會失敗。

usage object

適用於 Qwen-Omni、Qwen-Omni-Realtime。本次請求用量資訊。

屬性

count integer

本次請求實際計入費用的“建立音色”次數,本次請求的費用為 $count × 0.01。

建立音色時為 1;查詢或刪除音色不計費,為 0。

響應示例

建立

qwen3.8-omni-flash-realtime

響應結構

{
    "output": {
        "voice": "yourVoice",
        "target_model": "qwen3.8-omni-flash-realtime"
    },
    "usage": {
        "count": 1
    },
    "request_id": "yourRequestId"
}

qwen3.8-livetranslate-flash-realtime

以下響應示例為節選。

{
  "output": {
    "voice": "VOICE_ID",
    "target_model": "qwen3.8-livetranslate-flash-realtime"
  },
  "request_id": "REQUEST_ID"
}

查詢列表

Qwen-Omni

{
    "output": {
        "voice_list": [
            {
                "voice": "yourVoice1",
                "gmt_create": "2025-08-11 17:59:32",
                "target_model": "qwen3.5-omni-plus-realtime"
            },
            {
                "voice": "yourVoice2",
                "gmt_create": "2025-08-11 17:38:10",
                "target_model": "qwen3.5-omni-plus-realtime"
            }
        ]
    },
    "usage": {
        "count": 0
    },
    "request_id": "yourRequestId"
}

刪除

Qwen-Omni

{
    "usage": {
        "count": 0
    },
    "request_id": "yourRequestId"
}

錯誤資訊

如遇報錯問題,請參見錯誤碼進行排查。

在模型呼叫中使用音色