APIWebhookCallback Events

Speech to Text

Để nhận các sự kiện dưới đây, đăng ký webhook với events chứa mã AI_STT:COMPLETED và/hoặc AI_STT:FAILED (xem Danh sách sự kiện hỗ trợ).

AI_STT:COMPLETED

Gửi khi job Speech to Text (POST /stt) xử lý xong. data giống hệt response của endpoint đồng bộ tương ứng (SttResponse).

1{
2  "event": "AI_STT:COMPLETED",
3  "data": {
4    "trackingId": "018f8b3c-5e2a-7c1a-9b3e-3a2c1e4f5a6b",
5    "transcript": "Xin chào, đây là bản ghi âm từ OMICX",
6    "audioDuration": 5,
7    "fileSizeBytes": 245760,
8    "inputAudioFileName": "recording.wav",
9    "inputAudioUrl": "https://storage.omicx.one/stt-input/xyz789.wav?X-Amz-Expires=300",
10    "processingTimeMs": 842
11  }
12}

Lưu ý: inputAudioUrl là presigned URL tạm thời — có thể đã hết hạn vào thời điểm bạn nhận được webhook.

AI_STT:FAILED

Gửi khi job Speech to Text (POST /stt) xử lý thất bại. data dùng chung định dạng lỗi (ErrorResponse) như endpoint đồng bộ.

1{
2  "event": "AI_STT:FAILED",
3  "data": {
4    "error": {
5      "code": "BAD_GATEWAY",
6      "subCode": "AI_PROVIDER_ERROR",
7      "message": "STT processing failed",
8      "timestamp": "2026-01-01T00:00:00Z",
9      "path": "/stt"
10    }
11  }
12}