Skip to main content

Qwen-Audio-TTS HTTP API

API HTTP sintesis ucapan non-real-time Qwen-Audio-TTS, mencakup panggilan non-streaming dan SSE, parameter permintaan, serta bidang respons.

Endpoint

Ganti YOUR_WORKSPACE_ID dengan ID ruang kerja wilayah tersebut dan gunakan kunci API dari wilayah yang sama.
  • Singapura
  • Tiongkok (Beijing)
POST https://YOUR_WORKSPACE_ID.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/SpeechSynthesizer

Header permintaan

ParameterJenisWajibDeskripsi
AuthorizationstringWajibToken autentikasi dalam format Bearer <your_api_key>.
Content-TypestringWajibTetapkan ke application/json.
X-DashScope-SSEstringOpsionalTetapkan ke enable untuk keluaran streaming. Jika tidak disertakan, hasil lengkap dikembalikan.

Contoh panggilan

  • Non-streaming
  • Streaming
curl -X POST "https://YOUR_WORKSPACE_ID.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/SpeechSynthesizer" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-audio-3.1-tts-flash",
  "input": {
    "text": "你好,今天的天气真不错。",
    "voice": "longanhuan_v3.1",
    "format": "wav",
    "sample_rate": 24000
  }
}'
Satu peristiwa SSE dapat memuat beberapa baris data:. Gabungkan seluruh baris data: per peristiwa sebelum mengurai JSON. Dekode Base64 dan gabungkan potongan audio sesuai urutan peristiwa. Bingkai akhir memiliki output.finish_reason=stop dan mengembalikan URL audio lengkap.

Isi permintaan

ParameterJenisWajibDefaultDeskripsi
modelstringWajib—ID model sintesis ucapan. Lihat model dan wilayah pada Sintesis ucapan non-real-time.
inputobjectWajib—Objek parameter masukan.
input.textstringWajib—Teks yang akan disintesis. Untuk SSML, tetapkan enable_ssml=true. LaTeX tidak memerlukan pengaturan tambahan. Lihat SSML dan LaTeX untuk cakupan, tag, dan sintaks.
input.voicestringWajib—ID suara. Lihat daftar suara untuk suara sistem. Buat suara kustom melalui kloning suara atau desain suara, lalu gunakan model tujuan yang terikat.
input.formatstringOpsionalmp3Pengodean audio. Nilai: mp3, pcm, wav, opus.
input.sample_rateintegerOpsional22050Laju sampel audio dalam Hz. Nilai: 8000, 12000, 16000, 22050, 24000, 44100, 48000. Jika format=opus, hanya 8000, 12000, 16000, 24000, 48000 yang didukung.
input.volumeintegerOpsional50Volume. Rentang: [0, 100].
input.ratefloatOpsional1.0Kecepatan berbicara. Rentang: [0.5, 2.0].
input.bit_rateintegerOpsional32Bitrate audio dalam kbps. Rentang: [6, 510]. Hanya berlaku jika format=opus.
input.pitchfloatOpsional1.0Nada. Rentang: [0.5, 2.0].
input.enable_ssmlbooleanOpsional—Apakah SSML diaktifkan. Lihat batas penggunaan untuk batas model, suara, dan antarmuka.
input.word_timestamp_enabledbooleanOpsionalfalseApakah stempel waktu per kata dikembalikan. Hanya untuk streaming. Suara hasil kloning didukung. Lihat daftar suara untuk suara sistem yang didukung.
input.seedintegerOpsional0Seed acak. Rentang: [0, 65535]. Dengan versi model, teks, suara, serta parameter lain yang sama, seed yang sama mereproduksi hasil sintesis yang sama.
input.language_hintsarray[string]Opsional—
Untuk suara multibahasa dan dialek pada qwen-audio-3.1-tts-flash, parameter ini menentukan bahasa atau dialek. Lihat pengaturan suara multibahasa dan dialek untuk detailnya.
Bahasa tujuan sintesis. Hanya elemen pertama array yang diproses. Parameter ini terpisah dari bahasa sumber sampel kloning. Gunakan jika pelafalan angka, singkatan, simbol, atau bahasa yang lebih jarang digunakan tidak sesuai harapan. Kode bahasa tercantum di bawah. Untuk bahasa sumber kloning, lihat API kloning suara.
input.instructionstringOpsional—Instruksi pengendali dialek, emosi, atau peran. Lihat Kontrol instruksi untuk model, suara, dan penggunaannya.
input.enable_aigc_tagbooleanOpsionalfalseApakah pengenal AIGC tak terlihat disisipkan ke audio WAV, MP3, atau Opus.
input.aigc_propagatorstringOpsionalUID Alibaba CloudBidang ContentPropagator yang mengidentifikasi distributor. Hanya berlaku dengan enable_aigc_tag=true.
input.aigc_propagate_idstringOpsionalRequest ID permintaan iniBidang PropagateID yang mengidentifikasi operasi distribusi ini. Hanya berlaku dengan enable_aigc_tag=true.
input.hot_fixobjectOpsional—Konfigurasi perbaikan teks. pronunciation menyesuaikan pelafalan kata tertentu. replace mengganti teks tertentu sebelum sintesis.

Kode bahasa

  • zh: Mandarin
  • en: Inggris
  • fr: Prancis
  • de: Jerman
  • ja: Jepang
  • ko: Korea
  • ru: Rusia
  • pt: Portugis
  • th: Thai
  • id: Indonesia
  • vi: Vietnam
  • es: Spanyol
  • it: Italia
  • ms: Melayu
  • fil: Filipina
  • ar: Arab
  • other: Bahasa lain (didukung oleh qwen-audio-3.1-tts-flash) Bulgaria, Belanda, Hungaria, Rumania, Denmark, Kroasia, Yunani, Ceko, Norwegia, Swedia, Hindi, Slovak, Finlandia, Urdu, Serbia, Spanyol (Meksiko), Lituania, Latvia, Turki, Persia, Ibrani, Mongolia, Slovenia, Azerbaijan, Polandia, Katalan, Khmer, Portugis (Brasil), Lao, Georgia, Afrikaans, Nepali, Belarusia, Malayalam, Luksemburg, Albania, Tamil, Sinhala, Telugu, Estonia, Cebuano, Bosnia, Burma, Armenia, Latin, Islandia, Malta, Swahili, Kazakh, Seselwa Kreol Prancis, Ukraina.
Contoh konfigurasi perbaikan teks:
{
  "hot_fix": {
    "pronunciation": [
      {
        "天气": "tian1 qi4"
      }
    ],
    "replace": [
      {
        "今天": "金天"
      }
    ]
  }
}

Isi respons

ParameterJenisDeskripsi
request_idstringPengenal unik permintaan.
outputobjectKeluaran model.
output.finish_reasonstringAlasan berhenti. null berarti sintesis berlangsung; stop berarti sintesis selesai.
output.typestringHanya dikembalikan pada streaming. sentence-begin menandai awal kalimat; sentence-synthesis menandai potongan audio, dengan beberapa potongan per kalimat; sentence-end menandai akhir beserta penggunaan. Potongan audio dan bingkai data berkorespondensi satu per satu. Tambahkan potongan ke berkas yang sama secara berurutan.
output.original_textstringKalimat hasil segmentasi teks masukan. Bidang ini dapat tidak ada pada kalimat terakhir.
output.sentenceobjectInformasi kalimat.
output.sentence.indexintegerIndeks kalimat, dimulai dari 0.
output.sentence.wordsarrayKata dalam kalimat dan informasi stempel waktunya.
output.sentence.words[].textstringSebuah kata atau karakter.
output.sentence.words[].begin_indexintegerPosisi awal dalam kalimat, dimulai dari 0.
output.sentence.words[].end_indexintegerPosisi akhir dalam kalimat, dimulai dari 1.
output.sentence.words[].begin_timeintegerStempel waktu awal audio kata, dalam milidetik.
output.sentence.words[].end_timeintegerStempel waktu akhir audio kata, dalam milidetik.
output.audioobjectAudio hasil sintesis.
output.audio.datastringPotongan audio Base64 untuk streaming. Kosong untuk non-streaming.
output.audio.urlstringURL berkas audio lengkap, berlaku 24 jam.
output.audio.idstringPengenal audio hasil sintesis.
output.audio.expires_atintegerStempel waktu kedaluwarsa url.
usageobjectInformasi penggunaan.
qwen-audio-3.1-tts-flash ditagih berdasarkan Token input dan output. qwen-audio-3.1-tts-plus, qwen-audio-3.0-tts-plus, dan qwen-audio-3.0-tts-flash ditagih berdasarkan karakter.
usage.input_tokensintegerToken masukan. Hanya berlaku untuk qwen-audio-3.1-tts-plus, qwen-audio-3.1-tts-flash.
usage.output_tokensintegerToken keluaran. Hanya berlaku untuk qwen-audio-3.1-tts-plus, qwen-audio-3.1-tts-flash.
usage.total_tokensintegerJumlah token masukan dan keluaran. Hanya berlaku untuk qwen-audio-3.1-tts-plus, qwen-audio-3.1-tts-flash.
usage.charactersintegerJumlah kumulatif karakter yang ditagih.
  • Non-streaming
  • Streaming
{
  "output": {
    "audio": {
      "data": "",
      "id": "audio_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "expires_at": 1792079569,
      "url": "https://example.com/output.wav"
    },
    "finish_reason": "stop"
  },
  "usage": {
    "input_tokens": 12,
    "output_tokens": 30,
    "total_tokens": 42,
    "characters": 22
  },
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}