Danh Sách Lỗi API cho Các Yêu Cầu

Trang này cung cấp tổng quan toàn diện về các thông báo ngoại lệ có thể được trả về bởi dịch vụ. Các thông báo ngoại lệ này được phân loại dựa trên loại yêu cầu hoặc thao tác, cung cấp thông tin chi tiết về các sự cố tiềm ẩn gặp phải trong quá trình sử dụng dịch vụ, chẳng hạn như Yêu Cầu Không Có Kịch Bản, Yêu Cầu Có Kịch Bản, và các lỗi Xác Thực hoặc Xử Lý Âm Thanh cụ thể.

Mỗi lỗi được liệt kê kèm theo:

• Tên: Tên của ngoại lệ.
• Thông báo: Thông báo lỗi chi tiết được hệ thống trả về.
• Tham số: Bất kỳ thông tin bổ sung hoặc ngữ cảnh nào cần thiết cho lỗi.
• Mô tả: Giải thích ngắn gọn về thời điểm và lý do xảy ra lỗi.

Sử dụng danh sách này như một tài liệu tham khảo để hiểu, gỡ lỗi và xử lý các sự cố tiềm ẩn khi tương tác với API một cách hiệu quả.

Yêu Cầu Không Có Kịch Bản​

Các yêu cầu không có kịch bản liên quan đến các thao tác thời gian thực hoặc bất đồng bộ, nơi API xử lý đầu vào một cách động mà không dựa trên các kịch bản hoặc quy trình làm việc được định nghĩa sẵn. Các yêu cầu này thường được sử dụng cho các tình huống như xử lý âm thanh trực tiếp, các tác vụ ASR (Nhận Dạng Giọng Nói Tự Động) tức thời, hoặc các tương tác động khác.

Ngoại Lệ ASR​

Ngoại Lệ

Thông Báo

Tham Số

Mô Tả

ASRInterProcessException

exception in ASR: {error}

error (str): Chi tiết của lỗi.

Xuất hiện khi có ngoại lệ liên tiến trình trong hệ thống ASR.

ASRSocketTimeout

ASR timeout

None

Xuất hiện khi hệ thống ASR hết thời gian chờ trong quá trình xử lý.

ASRConnectionFailed

ASR Connection Failed

None

Xuất hiện khi kết nối đến hệ thống ASR thất bại.

Ngoại Lệ Âm Thanh​

Ngoại Lệ

Thông Báo

Tham Số

Mô Tả

FailedToReadAudioFromURL

Failed to read audio from the URL

None

Xuất hiện khi máy chủ không thể đọc âm thanh từ URL được cung cấp.

FailedToParseAudioHeader

Failed to parse audio header

None

Xuất hiện khi không thể phân tích tiêu đề âm thanh.

InvalidAudioFormat

Only 16 kHz mono WAV, FLAC or OGG-Opus audio allowed

None

Xuất hiện khi định dạng âm thanh được cung cấp không hợp lệ.

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): Định dạng của âm thanh không thể chuyển đổi.

Xuất hiện khi máy chủ không thể chuyển đổi định dạng âm thanh được cung cấp.

FailedToDecodeAudioFromBytes

Failed to decode audio

None

Xuất hiện khi máy chủ không thể giải mã dữ liệu âm thanh từ các byte.

MissingAudioParam

Missing audio param!

None

Xuất hiện khi tham số audio bắt buộc bị thiếu.

AudioTooBigForSync

Audio is too big for sync mode, please change to async mode

stream_dir (str): Thư mục hoặc vị trí của luồng âm thanh.

Xuất hiện khi âm thanh được cung cấp quá lớn để xử lý đồng bộ.

FailedToUseAudio

An unexpected error occurred while processing the audio. Please check if the audio is valid and it's not corrupted.

None

Xuất hiện khi xảy ra lỗi không mong muốn trong quá trình xử lý âm thanh.

Ngoại Lệ Xác Thực​

Ngoại Lệ

Thông Báo

Tham Số

Mô Tả

NoTokenProvided

No session token provided

None

Xuất hiện khi không có token phiên nào được cung cấp.

InvalidSessionToken

Invalid session token: {token}

token (str): Token phiên không hợp lệ.

Xuất hiện khi token phiên không hợp lệ được cung cấp.

UserDoesNotExist

Could not find {user_type} ID

user_type (str): Loại ID người dùng.

Xuất hiện khi người dùng được chỉ định không tồn tại.

ClientIsNotActive

Client with {user_id} is not active

user_id (str): ID người dùng.

Xuất hiện khi client được chỉ định không hoạt động.

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): ID người dùng.

Xuất hiện khi client được chỉ định không có quyền truy cập vào API.

ClientHasNoMoreMinutes

User has no remaining minutes

None

Xuất hiện khi người dùng không còn phút nào để sử dụng API.

Yêu Cầu Có Kịch Bản​

Các yêu cầu có kịch bản liên quan đến các quy trình làm việc hoặc thao tác được định nghĩa sẵn, tuân theo một trình tự hoặc kịch bản cụ thể. Các yêu cầu này thường được sử dụng trong các tình huống mà đầu vào và đầu ra dự kiến được xác định rõ ràng, chẳng hạn như xử lý âm thanh dựa trên kịch bản được định nghĩa trước, thực thi các tác vụ tự động, hoặc xử lý các quy trình làm việc có cấu trúc.

Ngoại Lệ Âm Thanh​

Ngoại Lệ

Thông Báo

Tham Số

Mô Tả

MissingAudioParam

Missing audio param!

None

Xuất hiện khi tham số audio bắt buộc bị thiếu.

FailedToReadAudioFromURL

Failed to read audio from the URL

None

Xuất hiện khi máy chủ không thể đọc âm thanh từ URL được cung cấp.

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): Định dạng của âm thanh không thể chuyển đổi.

Xuất hiện khi máy chủ không thể chuyển đổi định dạng âm thanh được cung cấp.

FailedToUseAudio

An unexpected error occurred while processing the audio. Please check if the audio is valid and it's not corrupted.

None

Xuất hiện khi xảy ra lỗi không mong muốn trong quá trình xử lý âm thanh.

Ngoại Lệ Xác Thực​

Ngoại Lệ

Thông Báo

Tham Số

Mô Tả

NoTokenProvided

No session token provided

None

Xuất hiện khi không có token phiên nào được cung cấp.

ClientIsNotActive

Client with {user_id} is not active

user_id (str): ID người dùng.

Xuất hiện khi client được chỉ định không hoạt động.

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): ID người dùng.

Xuất hiện khi client được chỉ định không có quyền truy cập vào API.

UserDoesNotExist

Could not find {user_type} ID

user_type (str): Loại ID người dùng.

Xuất hiện khi người dùng được chỉ định không tồn tại.

InvalidHeaderParameter

A valid authorization header is required

None

Xuất hiện khi tiêu đề ủy quyền không hợp lệ hoặc bị thiếu.