Text to Speech

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

AI_TTS:COMPLETED

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

1
{
2
  "event": "AI_TTS:COMPLETED",
3
  "data": {
4
    "trackingId": "018f8b3c-6d1b-7a2c-8e4f-5b6c7d8e9f0a",
5
    "audioUrl": "https://api.omicx.one/tts/audio?k=MDE5ZjY4ZmE...",
6
    "audioDuration": 3.4,
7
    "fileSizeBytes": 68432,
8
    "languageCode": "vi-VN",
9
    "processingTimeMs": 512
10
  }
11
}

Lưu ý: audioUrl trỏ tới endpoint tải xuống self-host của public-service (GET /tts/audio), sống tối đa 30 ngày theo TTL file.

AI_TTS:FAILED

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

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

Danh mục sự kiện hiện chỉ hỗ trợ 4 loại trên (AI_STT/AI_TTS, COMPLETED/FAILED) — đây là danh mục chỉ thêm mới (append-only), OMICX có thể bổ sung thêm sự kiện khác trong tương lai.