Server-sent events untuk pengenalan ucapan real-time (Paraformer)

Panduan pengguna: Untuk detail model dan panduan pemilihan, lihat Speech-to-text. Alur interaksi event: Untuk diagram sekuens event, lihat WebSocket API.

task-started

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

headerobject

Properties

task_idstringID tugas yang dihasilkan klien (format UUID).eventstringJenis event. Selalu task-started.attributesobjectAtribut tambahan. Biasanya kosong.

payloadobjectSelalu {}.

{
    "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).

headerobject

Properties

task_idstringID tugas yang dihasilkan klien (format UUID).eventstringJenis event. Selalu result-generated.

payloadobject

Properties

outputobject

Properties

usageobjectKetika 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 menunjukkan durasi tagihan tugas saat ini.

Properties

durationintegerDurasi tugas yang dikenai biaya, dalam satuan detik.

Properties

sentenceobject

Properties

begin_timeintegerWaktu mulai kalimat, dalam milidetik.end_timeintegerWaktu akhir kalimat, dalam milidetik.textstringTeks yang dikenali.heartbeatbooleanJika bernilai true, Anda dapat melewati hasil ini (paket heartbeat).sentence_endbooleanApakah kalimat telah berakhir (true=hasil akhir, false=hasil antara).emo_tagstring

Hanya paraformer-realtime-8k-v2 yang mendukung fitur ini.
Fitur ini memerlukan segmentasi semantik dinonaktifkan. Atur semantic_punctuation_enabled ke false pada event run-task.
Hasil pengenalan emosi hanya dikembalikan ketika payload.output.sentence.sentence_end bernilai true.

Sentimen dari kalimat saat ini:

positive: Sentimen positif, seperti senang atau puas.
negative: Sentimen negatif, seperti marah atau kecewa.
neutral: Tidak ada sentimen yang jelas.

emo_confidencefloat

Hanya paraformer-realtime-8k-v2 yang mendukung fitur ini.
Fitur ini memerlukan segmentasi semantik dinonaktifkan. Atur semantic_punctuation_enabled ke false pada event run-task.
Hasil pengenalan emosi hanya dikembalikan ketika payload.output.sentence.sentence_end bernilai true.

Skor kepercayaan emosi dalam rentang [0.0, 1.0]. Nilai yang lebih tinggi menunjukkan kepercayaan yang lebih besar.wordsarray[object]Informasi timestamp tingkat kata.

Properties

begin_timeintegerWaktu mulai kata, dalam milidetik.end_timeintegerWaktu akhir kata, dalam milidetik.textstringTeks yang dikenali.punctuationstringTanda baca.

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

task-finished

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

headerobject

Properties

task_idstringID tugas yang dihasilkan klien (format UUID).eventstringJenis event. Selalu task-finished.attributesobjectAtribut tambahan. Biasanya kosong.

payloadobjectIsinya dapat diabaikan. 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_idstringID tugas yang dihasilkan klien (format UUID).eventstringJenis event. Selalu task-failed.error_codestringDeskripsi jenis error.error_messagestringPenyebab spesifik dari error tersebut.attributesobjectAtribut tambahan. Biasanya kosong.

payloadobjectSelalu {}.

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

​task-started

​result-generated

​task-finished

​task-failed

task-started

result-generated

task-finished

task-failed