Voice design

import requests
import base64
import os

response = requests.post(
  "https://dashscope-intl.aliyuncs.com/api/v1/services/audio/tts/customization",
  headers={
    "Authorization": f"Bearer {os.getenv('DASHSCOPE_API_KEY')}",
    "Content-Type": "application/json"
  },
  json={
    "model": "qwen-voice-design",
    "input": {
      "action": "create",
      "target_model": "qwen3-tts-vd-2026-01-26",
      "voice_prompt": "A calm young female voice with clear articulation "
                      "and gentle tone, suitable for audiobook narration.",
      "preview_text": "Hello, welcome to our program. "
                      "Today we will explore the wonders of nature.",
      "preferred_name": "narrator",
      "language": "en"
    },
    "parameters": {
      "sample_rate": 24000,
      "response_format": "wav"
    }
  },
  timeout=60
)

result = response.json()
voice_name = result["output"]["voice"]
print(f"Voice created: {voice_name}")

# Decode and save preview audio
audio_bytes = base64.b64decode(result["output"]["preview_audio"]["data"])
with open(f"{voice_name}_preview.wav", "wb") as f:
  f.write(audio_bytes)

import com.google.gson.Gson;
import com.google.gson.JsonObject;

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Base64;

public class VoiceDesign {
  public static void main(String[] args) {
    String apiKey = System.getenv("DASHSCOPE_API_KEY");
    String apiUrl = "https://dashscope-intl.aliyuncs.com/api/v1/services/audio/tts/customization";

    try {
      String body = "{"
        + "\"model\": \"qwen-voice-design\","
        + "\"input\": {"
        +   "\"action\": \"create\","
        +   "\"target_model\": \"qwen3-tts-vd-realtime-2026-01-15\","
        +   "\"voice_prompt\": \"A calm young female voice with clear articulation "
        +     "and gentle tone, suitable for audiobook narration.\","
        +   "\"preview_text\": \"Hello, welcome to our program. "
        +     "Today we will explore the wonders of nature.\","
        +   "\"preferred_name\": \"narrator\","
        +   "\"language\": \"en\""
        + "},"
        + "\"parameters\": {"
        +   "\"sample_rate\": 24000,"
        +   "\"response_format\": \"wav\""
        + "}"
        + "}";

      HttpURLConnection conn = (HttpURLConnection) new URL(apiUrl).openConnection();
      conn.setRequestMethod("POST");
      conn.setRequestProperty("Authorization", "Bearer " + apiKey);
      conn.setRequestProperty("Content-Type", "application/json");
      conn.setDoOutput(true);

      try (OutputStream os = conn.getOutputStream()) {
        os.write(body.getBytes("UTF-8"));
      }

      int status = conn.getResponseCode();
      InputStream is = (status >= 200 && status < 300)
        ? conn.getInputStream()
        : conn.getErrorStream();

      StringBuilder sb = new StringBuilder();
      try (BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8"))) {
        String line;
        while ((line = br.readLine()) != null) {
          sb.append(line);
        }
      }

      if (status == 200) {
        Gson gson = new Gson();
        JsonObject result = gson.fromJson(sb.toString(), JsonObject.class);
        JsonObject output = result.getAsJsonObject("output");
        String voiceName = output.get("voice").getAsString();
        System.out.println("Voice created: " + voiceName);

        // Decode and save preview audio
        String audioData = output.getAsJsonObject("preview_audio").get("data").getAsString();
        byte[] audioBytes = Base64.getDecoder().decode(audioData);
        try (FileOutputStream fos = new FileOutputStream(voiceName + "_preview.wav")) {
          fos.write(audioBytes);
        }
        System.out.println("Preview saved: " + voiceName + "_preview.wav");
      } else {
        System.err.println("Error " + status + ": " + sb.toString());
      }

    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

import requests
import os

voice_name = "VOICE_NAME"  # <-- from the create step

response = requests.post(
  "https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation",
  headers={
    "Authorization": f"Bearer {os.getenv('DASHSCOPE_API_KEY')}",
    "Content-Type": "application/json"
  },
  json={
    "model": "qwen3-tts-vd-2026-01-26",
    "input": {
      "text": "Welcome to our audiobook. "
              "Let me take you on a journey through the wonders of nature.",
      "voice": voice_name
    }
  },
  timeout=60
)

result = response.json()
audio_url = result["output"]["audio"]["url"]
print(f"Audio URL: {audio_url}")

import com.google.gson.Gson;
import com.google.gson.JsonObject;

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;

public class VoiceDesignSynthesize {
  public static void main(String[] args) {
    String apiKey = System.getenv("DASHSCOPE_API_KEY");
    String voiceName = "VOICE_NAME"; // <-- from the create step

    try {
      String body = "{"
        + "\"model\": \"qwen3-tts-vd-2026-01-26\","
        + "\"input\": {"
        +   "\"text\": \"Welcome to our audiobook. "
        +     "Let me take you on a journey through the wonders of nature.\","
        +   "\"voice\": \"" + voiceName + "\""
        + "}"
        + "}";

      HttpURLConnection conn = (HttpURLConnection) new URL(
        "https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation"
      ).openConnection();
      conn.setRequestMethod("POST");
      conn.setRequestProperty("Authorization", "Bearer " + apiKey);
      conn.setRequestProperty("Content-Type", "application/json");
      conn.setDoOutput(true);

      try (OutputStream os = conn.getOutputStream()) {
        os.write(body.getBytes("UTF-8"));
      }

      int status = conn.getResponseCode();
      InputStream is = (status >= 200 && status < 300)
        ? conn.getInputStream()
        : conn.getErrorStream();

      StringBuilder sb = new StringBuilder();
      try (BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8"))) {
        String line;
        while ((line = br.readLine()) != null) {
          sb.append(line);
        }
      }

      if (status == 200) {
        Gson gson = new Gson();
        JsonObject result = gson.fromJson(sb.toString(), JsonObject.class);
        String audioUrl = result.getAsJsonObject("output")
          .getAsJsonObject("audio").get("url").getAsString();
        System.out.println("Audio URL: " + audioUrl);

        // Download the audio file
        try (InputStream in = new URL(audioUrl).openStream();
             FileOutputStream out = new FileOutputStream("synthesis_output.wav")) {
          byte[] buffer = new byte[4096];
          int bytesRead;
          while ((bytesRead = in.read(buffer)) != -1) {
            out.write(buffer, 0, bytesRead);
          }
        }
        System.out.println("Audio saved: synthesis_output.wav");
      } else {
        System.err.println("Error " + status + ": " + sb.toString());
      }

    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}