Callback API

Callback API áp dụng với Batch API và Realtime API (optional)

Khi request thành công, hệ thống sẽ gửi đến webhookURL một POST như sau

URL: callback url truyền lên khi gọi API create text

Method: POST

Tham số

Kiểu dữ liệu

Mô tả

transcriptId

String

ID transcript

status

String

Trạng thái của API

transcript

String

Văn bản nhận dạng ghép từ tất cả các utterances

utterances

String

Danh sách từng đoạn nhận dạng gồm text, startTime, endTime (giây)

audioDuration

String

Thời lượng WAV

errorMessage

String

Mã lỗi khi status = FAILED

// Payload webhook (POST về webhookUrl):

{
  "transcriptId": "job-uuid-456",
  "status": "COMPLETED",
  "transcript": "nội dung nhận dạng",
  "utterances": [...],
  "audioDuration": 8
}

// Khi status = FAILED

{
  "transcriptId": "job-uuid-456",
  "status": "FAILED",
  "errorMessage": "Provider reported failure",
  "audioDuration": 8
}

Last updated