Qwen-Audio-3.0-ASR-Flash-Streaming/Fun-ASR-Realtime real-time speech recognition server-side events - Alibaba Cloud Model Studio

Layanan pengenalan ucapan real-time Qwen-Audio-3.0-ASR-Flash-Streaming/Fun-ASR-Realtime mendorong server-side events ke klien melalui WebSocket. Topik ini menjelaskan struktur data dan deskripsi bidang dari empat jenis event: task-started, result-generated, task-finished, dan task-failed.

Panduan pengguna: Untuk deskripsi model dan panduan pemilihan, lihat Speech-to-text.

Alur interaksi event: Untuk memahami urutan interaksi event, lihat WebSocket API.

task-started

Deskripsi: Tugas telah berhasil dimulai. Klien dapat mulai mengirimkan data audio.

headerobject

Properties

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 {}.

{
    "header": {
        "task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
        "event": "task-started",
        "attributes": {}
    },
    "payload": {}
}

result-generated

Deskripsi: Hasil pengenalan, mencakup hasil antara (sentence_end=false) dan hasil akhir (sentence_end=true). Hasil antara pertama untuk kalimat baru mencakup sentence_begin=true.

headerobject

Properties

task_idstring

ID tugas yang dihasilkan oleh klien (dalam format UUID).

eventstring

Jenis event. Nilai ini selalu result-generated.

payloadobject

Properties

outputobject

Properties

usageobject

Ketika payload.output.sentence.sentence_end bernilai false (kalimat saat ini belum berakhir), usage bernilai null.

Ketika payload.output.sentence.sentence_end bernilai true (kalimat saat ini telah berakhir), usage.duration adalah durasi tagihan untuk tugas saat ini.

Properties

durationinteger

Durasi tugas yang ditagih, dalam satuan detik.

Properties

sentenceobject

Properties

begin_timeinteger

Waktu mulai kalimat, dalam milidetik.

end_timeinteger

Waktu akhir kalimat, dalam milidetik.

textstring

Teks yang dikenali.

heartbeatboolean

Jika nilai ini true, hasil tersebut merupakan paket heartbeat dan dapat diabaikan.

sentence_beginboolean

Menunjukkan awal sebuah kalimat.

sentence_endboolean

Apakah kalimat telah berakhir (true = hasil akhir, false = hasil antara).

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.

wordsarray[object]

Informasi timestamp tingkat kata.

Properties

begin_timeinteger

Waktu mulai kata, dalam milidetik.

end_timeinteger

Waktu akhir kata, dalam milidetik.

textstring

Teks yang dikenali.

punctuationstring

Tanda baca.

Sentence-start result:

{
  "header": {
    "task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
    "event": "result-generated",
    "attributes": {}
  },
  "payload": {
    "output": {
      "sentence": {
        "begin_time": 0,
        "end_time": null,
        "text": "",
        "sentence_begin": true,
        "sentence_end": false,
        "sentence_id": 1,
        "words": []
      }
    },
    "usage": null
  }
}

Final result:

{
  "header": {
    "task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
    "event": "result-generated",
    "attributes": {}
  },
  "payload": {
    "output": {
      "sentence": {
        "begin_time": 170,
        "end_time": 920,
        "text": "OK, got it.",
        "heartbeat": false,
        "sentence_end": true,
        "sentence_id": 1,
        "words": [
          {
            "begin_time": 170,
            "end_time": 295,
            "text": "OK",
            "punctuation": ","
          },
          {
            "begin_time": 295,
            "end_time": 503,
            "text": "got",
            "punctuation": ""
          },
          {
            "begin_time": 503,
            "end_time": 711,
            "text": "it",
            "punctuation": ""
          },
          {
            "begin_time": 711,
            "end_time": 920,
            "text": "",
            "punctuation": "."
          }
        ]
      }
    },
    "usage": {
      "duration": 3
    }
  }
}

task-finished

Deskripsi: Tugas telah berakhir secara normal. Anda dapat menutup koneksi atau menggunakannya kembali.

headerobject

Properties

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

Anda dapat mengabaikan bidang ini. Nilai ini biasanya {}.

{
    "header": {
        "task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
        "event": "task-finished",
        "attributes": {}
    },
    "payload": {
        "output": {},
        "usage": null
    }
}

task-failed

Deskripsi: Tugas gagal. Koneksi ditutup dan tidak dapat digunakan kembali.

headerobject

Properties

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 {}.

{
    "header": {
        "task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
        "event": "task-failed",
        "error_code": "CLIENT_ERROR",
        "error_message": "request timeout after 23 seconds.",
        "attributes": {}
    },
    "payload": {}
}