Skip to main content

Peristiwa server Qwen-Audio-ASR-Streaming

Referensi peristiwa server Qwen-Audio-ASR-Streaming: awal tugas, hasil pengenalan, penyelesaian, kegagalan, dan permintaan terkait.

Alur peristiwa

  1. Kirim run-task. Tunggu task-started sebelum mengirim audio.
  2. Terus kirim audio sambil menerima peristiwa result-generated.
  3. Setelah semua audio terkirim, kirim finish-task dan terima hasil hingga task-finished diterima. Tugas yang gagal mengembalikan task-failed.
Audio tidak dikirim melalui run-task: WebSocket menggunakan frame biner, sedangkan AOQ menggunakan Audio Track. Untuk koneksi, autentikasi, dan transmisi audio, lihat API WebSocket atau akses AOQ.

task-started

Menunjukkan bahwa tugas berhasil dimulai dan klien dapat mulai mengirim audio.
Tunggu task-started sebelum mengirim audio. run-task hanya memulai dan mengonfigurasi tugas; peristiwa ini tidak memuat data audio.
headerobject
task_idstring
ID tugas yang dihasilkan oleh klien (dalam format UUID).
eventstring
Jenis event. Nilai ini selalu task-started.
attributesobject
Atribut tambahan. Nilai ini biasanya kosong.
payloadobject
Nilai ini selalu {}.
Permintaan:
{
  "header": {
    "action": "run-task",
    "task_id": "3d30b8aa-8859-46ef-a65a-32cf5a9f0ca4",
    "streaming": "duplex"
  },
  "payload": {
    "task_group": "audio",
    "task": "asr",
    "function": "recognition",
    "model": "qwen-audio-3.1-asr-flash-streaming",
    "parameters": {
      "format": "pcm",
      "sample_rate": 16000
    },
    "input": {}
  }
}
Respons:
{
  "header": {
    "task_id": "3d30b8aa-8859-46ef-a65a-32cf5a9f0ca4",
    "task_uuid": "f32fbf86736e4c279b5d133bff74b657",
    "event": "task-started",
    "attributes": {}
  },
  "payload": {}
}

result-generated

Mengembalikan hasil pengenalan, termasuk awal kalimat, hasil sementara, hasil akhir kalimat, dan heartbeat.
sentence_end=true menandai akhir kalimat, bukan akhir tugas. Hasil heartbeat (heartbeat=true) dapat dilewati. Tugas berakhir saat task-finished diterima.
headerobject
task_idstring
ID tugas yang dihasilkan oleh klien (dalam format UUID).
eventstring
Jenis event. Nilai ini selalu result-generated.
payloadobject
outputobject
sentenceobject
sentence_idinteger
Identifikasi urutan kalimat. Pada hasil pengenalan normal, sentence_id bertambah dari 1. Ketika heartbeat bernilai true (yaitu, paket heartbeat), sentence_id selalu 0.
begin_timeinteger
Waktu mulai kalimat, dalam milidetik.
end_timeinteger | null
Waktu akhir kalimat, dalam milidetik. Dapat bernilai null pada hasil sementara atau heartbeat.
textstring
Teks yang dikenali.
sentence_beginboolean
Menunjukkan awal sebuah kalimat.
sentence_endboolean
Apakah kalimat telah berakhir (true = hasil akhir, false = hasil antara).
heartbeatboolean
Jika nilai ini true, hasil tersebut merupakan paket heartbeat dan dapat diabaikan.
wordsarray[object]
Informasi timestamp tingkat kata.
begin_timeinteger
Waktu mulai kata, dalam milidetik.
end_timeinteger
Waktu akhir kata, dalam milidetik.
textstring
Teks yang dikenali.
punctuationstring
Tanda baca.
usageobject
Penggunaan kumulatif untuk tugas saat ini.
usage berisi penggunaan kumulatif tugas saat ini dan mungkin tidak ada pada sebagian hasil sementara. Jangan menjumlahkan usage antarperistiwa. qwen-audio-3.0-asr-flash-streaming ditagih berdasarkan durasi dan qwen-audio-3.1-asr-flash-streaming berdasarkan token. Lihat cakupan pada deskripsi bidang.
durationinteger
Durasi audio kumulatif, dalam detik.
Digunakan untuk penagihan qwen-audio-3.0-asr-flash-streaming.
input_tokensinteger
Jumlah token input kumulatif.
Berlaku untuk qwen-audio-3.1-asr-flash-streaming.
output_tokensinteger
Jumlah token output kumulatif.
Berlaku untuk qwen-audio-3.1-asr-flash-streaming.
total_tokensinteger
Jumlah total token kumulatif, yaitu jumlah token input dan output.
Berlaku untuk qwen-audio-3.1-asr-flash-streaming.
  • Awal kalimat
  • Hasil sementara
  • Hasil akhir kalimat
  • Heartbeat
Setelah menerima task-started, kirim audio. Contoh berikut adalah satu peristiwa result-generated yang kemudian dikembalikan server. Audio dikirim melalui frame biner WebSocket atau Audio Track AOQ.
Permintaan:
{
  "header": {
    "action": "run-task",
    "task_id": "3d30b8aa-8859-46ef-a65a-32cf5a9f0ca4",
    "streaming": "duplex"
  },
  "payload": {
    "task_group": "audio",
    "task": "asr",
    "function": "recognition",
    "model": "qwen-audio-3.1-asr-flash-streaming",
    "parameters": {
      "format": "pcm",
      "sample_rate": 16000
    },
    "input": {}
  }
}
Respons:
{
  "header": {
    "task_id": "3d30b8aa-8859-46ef-a65a-32cf5a9f0ca4",
    "event": "result-generated",
    "attributes": {}
  },
  "payload": {
    "output": {
      "sentence": {
        "sentence_id": 1,
        "begin_time": 0,
        "end_time": null,
        "text": "",
        "channel_id": 0,
        "sentence_end": false,
        "sentence_begin": true,
        "words": []
      },
      "text": "",
      "request_id": "3d30b8aa-8859-46ef-a65a-32cf5a9f0ca4",
      "output": {
        "sentence": {
          "sentence_id": 1,
          "begin_time": 0,
          "end_time": null,
          "text": "",
          "channel_id": 0,
          "sentence_end": false,
          "sentence_begin": true,
          "words": []
        },
        "text": "",
        "request_id": "3d30b8aa-8859-46ef-a65a-32cf5a9f0ca4"
      }
    }
  }
}

task-finished

Menunjukkan bahwa pemrosesan tugas selesai. Semua hasil pengenalan tugas telah dikembalikan.
headerobject
task_idstring
ID tugas yang dihasilkan oleh klien (dalam format UUID).
eventstring
Jenis event. Nilai ini selalu task-finished.
attributesobject
Atribut tambahan. Nilai ini biasanya kosong.
payloadobject
usageobject
Penggunaan kumulatif pada akhir tugas. Arti bidang sama dengan result-generated.usage.
Permintaan:
{
  "header": {
    "action": "finish-task",
    "task_id": "3d30b8aa-8859-46ef-a65a-32cf5a9f0ca4",
    "streaming": "duplex"
  },
  "payload": {
    "input": {}
  }
}
Respons:
{
  "header": {
    "task_id": "3d30b8aa-8859-46ef-a65a-32cf5a9f0ca4",
    "event": "task-finished",
    "attributes": {}
  },
  "payload": {
    "output": {},
    "usage": {
      "duration": 4,
      "input_tokens": 50,
      "output_tokens": 13,
      "total_tokens": 63
    }
  }
}

task-failed

Menunjukkan bahwa tugas gagal. Periksa error_code dan error_message untuk mengetahui penyebabnya. Setelah tugas gagal, koneksi WebSocket ditutup dan tidak dapat digunakan kembali.
headerobject
task_idstring
ID tugas yang dihasilkan oleh klien (dalam format UUID).
eventstring
Jenis event. Nilai ini selalu task-failed.
error_codestring
Deskripsi jenis error.
error_messagestring
Penyebab spesifik dari error tersebut.
attributesobject
Atribut tambahan. Nilai ini biasanya kosong.
payloadobject
Nilai ini selalu {}.
Permintaan ini menggunakan format audio yang tidak didukung untuk menunjukkan task-failed. Kode dan pesan kesalahan bergantung pada penyebab kegagalan.
Permintaan:
{
  "header": {
    "action": "run-task",
    "task_id": "9272a5a2-8df4-4f2d-af0e-e544c17f3e42",
    "streaming": "duplex"
  },
  "payload": {
    "task_group": "audio",
    "task": "asr",
    "function": "recognition",
    "model": "qwen-audio-3.1-asr-flash-streaming",
    "parameters": {
      "format": "invalid-format",
      "sample_rate": 16000
    },
    "input": {}
  }
}
Respons:
{
  "header": {
    "task_id": "9272a5a2-8df4-4f2d-af0e-e544c17f3e42",
    "event": "task-failed",
    "error_code": "UNSUPPORTED_FORMAT",
    "error_message": "UNSUPPORTED_FORMAT"
  },
  "payload": {}
}