Skip to main content

Peristiwa server Qwen-Audio-ASR-Message

Referensi peristiwa server Qwen-Audio-ASR-Message: bidang 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. Selama tugas berlangsung, gunakan continue-task untuk memperbarui konteks percakapan. Audio tetap dikirim melalui saluran audio.
  4. 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 dibuat klien, dalam format UUID.
eventstring
Jenis peristiwa. Nilainya selalu task-started.
attributesobject
Atribut tambahan, biasanya kosong.
payloadobject
Nilainya selalu {}.
Permintaan:
{
  "header": {
    "action": "run-task",
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "streaming": "duplex"
  },
  "payload": {
    "input": {},
    "task_group": "audio",
    "task": "asr",
    "function": "recognition",
    "model": "qwen-audio-3.1-asr-flash-message",
    "parameters": {
      "format": "pcm",
      "sample_rate": 16000
    }
  }
}
Respons:
{
  "header": {
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "task_uuid": "852196dba9d14bea9cf0d6e04ff0b027",
    "event": "task-started",
    "attributes": {}
  },
  "payload": {}
}

result-generated

Mengembalikan hasil pengenalan, termasuk awal kalimat, hasil sementara, hasil akhir kalimat, dan heartbeat. Hasil sementara dinonaktifkan secara default; atur intermediate_result_enabled=true untuk mengaktifkannya.
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 dibuat klien, dalam format UUID.
eventstring
Jenis peristiwa. Nilainya selalu result-generated.
payloadobject
outputobject
sentenceobject
sentence_idinteger
Nomor urut kalimat. Dalam hasil normal, sentence_id bertambah mulai dari 1. Jika heartbeat bernilai true (paket heartbeat), sentence_id selalu 0.
begin_timeinteger
Waktu mulai kalimat, dalam milidetik.
end_timeinteger
Waktu akhir kalimat, dalam milidetik.Dapat bernilai null pada hasil sementara atau heartbeat.
textstring
Teks yang dikenali.
Teks sementara dapat berubah selama pengenalan berlangsung. Perbarui teks yang ditampilkan untuk sentence_id yang sama, bukan menggabungkan teks sementara secara langsung.
sentence_beginboolean
Nilai true menunjukkan awal kalimat. Bidang text dapat kosong pada saat ini.
sentence_endboolean
Menentukan apakah kalimat telah selesai (true: hasil akhir, false: hasil sementara).
heartbeatboolean
Jika nilainya true, hasil adalah 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 tugas saat ini hingga peristiwa ini.
usage berisi penggunaan kumulatif tugas saat ini. Jangan menjumlahkan nilai usage dari beberapa peristiwa. Setelah tugas selesai, gunakan penggunaan kumulatif akhir dalam task-finished.
durationinteger
Durasi audio kumulatif dalam detik, dipertahankan untuk kompatibilitas.
input_tokensinteger
Jumlah kumulatif token input.
output_tokensinteger
Jumlah kumulatif token output.
total_tokensinteger
Jumlah total token kumulatif: penjumlahan input_tokens dan output_tokens.
  • Awal kalimat
  • Hasil sementara
  • Hasil akhir kalimat
Permintaan:
{
  "header": {
    "action": "run-task",
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "streaming": "duplex"
  },
  "payload": {
    "input": {},
    "task_group": "audio",
    "task": "asr",
    "function": "recognition",
    "model": "qwen-audio-3.1-asr-flash-message",
    "parameters": {
      "format": "pcm",
      "sample_rate": 16000
    }
  }
}
Respons:
{
  "header": {
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "event": "result-generated",
    "attributes": {}
  },
  "payload": {
    "output": {
      "sentence": {
        "sentence_id": 1,
        "begin_time": 0,
        "end_time": null,
        "text": "",
        "sentence_end": false,
        "sentence_begin": true,
        "words": []
      }
    }
  }
}

task-finished

Pemrosesan tugas selesai dan semua hasil pengenalan telah dikembalikan. Klien dapat menutup koneksi atau menggunakannya kembali untuk memulai tugas baru.
headerobject
task_idstring
ID tugas yang dibuat klien, dalam format UUID.
eventstring
Jenis peristiwa. Nilainya selalu task-finished.
attributesobject
Atribut tambahan, biasanya kosong.
payloadobject
Berisi output (objek kosong) dan usage (penggunaan kumulatif akhir tugas). Bidang usage didefinisikan sama seperti pada result-generated.
Permintaan:
{
  "header": {
    "action": "finish-task",
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "streaming": "duplex"
  },
  "payload": {
    "input": {}
  }
}
Respons:
{
  "header": {
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "event": "task-finished",
    "attributes": {}
  },
  "payload": {
    "output": {},
    "usage": {
      "duration": 4,
      "input_tokens": 51,
      "output_tokens": 13,
      "total_tokens": 64
    }
  }
}

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 dibuat klien, dalam format UUID.
eventstring
Jenis peristiwa. Nilainya selalu task-failed.
error_codestring
Deskripsi jenis kesalahan.
error_messagestring
Penyebab spesifik kesalahan.
attributesobject
Atribut tambahan, biasanya kosong.
payloadobject
Nilainya 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": "5927b897-6890-45cd-9b85-bc58bdaaadfb",
    "streaming": "duplex"
  },
  "payload": {
    "input": {},
    "task_group": "audio",
    "task": "asr",
    "function": "recognition",
    "model": "qwen-audio-3.1-asr-flash-message",
    "parameters": {
      "format": "invalid-format",
      "sample_rate": 16000
    }
  }
}
Respons:
{
  "header": {
    "task_id": "5927b897-6890-45cd-9b85-bc58bdaaadfb",
    "event": "task-failed",
    "error_code": "UNSUPPORTED_FORMAT",
    "error_message": "UNSUPPORTED_FORMAT"
  },
  "payload": {}
}