รายการข้อผิดพลาด API สำหรับคำขอ

หน้านี้ให้ภาพรวมที่ครอบคลุมเกี่ยวกับข้อความข้อยกเว้นที่อาจถูกส่งคืนโดยบริการ ข้อความข้อยกเว้นเหล่านี้ถูกจัดหมวดหมู่ตามประเภทของคำขอหรือการดำเนินการ โดยให้ข้อมูลเชิงลึกโดยละเอียดเกี่ยวกับปัญหาที่อาจพบระหว่างการใช้บริการ เช่น คำขอที่ไม่มีสคริปต์ (Unscripted Requests), คำขอที่มีสคริปต์ (Scripted Requests) และข้อผิดพลาดเฉพาะด้าน การตรวจสอบสิทธิ์ (Authentication) หรือ การประมวลผลเสียง (Audio Processing)

แต่ละข้อผิดพลาดจะแสดงพร้อมกับ:

• ชื่อ (Name): ชื่อของข้อยกเว้น
• ข้อความ (Message): ข้อความข้อผิดพลาดโดยละเอียดที่ระบบส่งคืน
• พารามิเตอร์ (Parameters): ข้อมูลเพิ่มเติมหรือบริบทที่จำเป็นสำหรับข้อผิดพลาด
• คำอธิบาย (Description): คำอธิบายสั้น ๆ เกี่ยวกับเวลาและสาเหตุที่ข้อผิดพลาดเกิดขึ้น

ใช้รายการนี้เป็นข้อมูลอ้างอิงเพื่อทำความเข้าใจ แก้ไขข้อบกพร่อง และจัดการปัญหาที่อาจเกิดขึ้นเมื่อใช้งาน API ได้อย่างมีประสิทธิภาพ

คำขอที่ไม่มีสคริปต์ (Unscripted Requests)​

คำขอที่ไม่มีสคริปต์เกี่ยวข้องกับการดำเนินงานแบบเรียลไทม์หรือแบบอะซิงโครนัส ซึ่ง API ประมวลผลข้อมูลนำเข้าแบบไดนามิกโดยไม่พึ่งพาสคริปต์หรือเวิร์กโฟลว์ที่กำหนดไว้ล่วงหน้า คำขอเหล่านี้มักใช้สำหรับสถานการณ์ต่าง ๆ เช่น การประมวลผลเสียงสด งาน ASR (การรู้จำเสียงพูดอัตโนมัติ) แบบเฉพาะกิจ หรือการโต้ตอบแบบไดนามิกอื่น ๆ

ข้อยกเว้น ASR​

ข้อยกเว้น

ข้อความ

พารามิเตอร์

คำอธิบาย

ASRInterProcessException

exception in ASR: {error}

error (str): รายละเอียดของข้อผิดพลาด

เกิดขึ้นเมื่อมีข้อยกเว้นระหว่างกระบวนการในระบบ ASR

ASRSocketTimeout

ASR timeout

None

เกิดขึ้นเมื่อระบบ ASR หมดเวลาขณะประมวลผล

ASRConnectionFailed

ASR Connection Failed

None

เกิดขึ้นเมื่อการเชื่อมต่อกับระบบ ASR ล้มเหลว

ข้อยกเว้นด้านเสียง (Audio Exceptions)​

ข้อยกเว้น

ข้อความ

พารามิเตอร์

คำอธิบาย

FailedToReadAudioFromURL

Failed to read audio from the URL

None

เกิดขึ้นเมื่อเซิร์ฟเวอร์ไม่สามารถอ่านเสียงจาก URL ที่ระบุได้

FailedToParseAudioHeader

Failed to parse audio header

None

เกิดขึ้นเมื่อไม่สามารถแยกวิเคราะห์ส่วนหัวของเสียงได้

InvalidAudioFormat

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

None

เกิดขึ้นเมื่อรูปแบบเสียงที่ระบุไม่ถูกต้อง

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): รูปแบบของเสียงที่การแปลงล้มเหลว

เกิดขึ้นเมื่อเซิร์ฟเวอร์ไม่สามารถแปลงรูปแบบเสียงที่ระบุได้

FailedToDecodeAudioFromBytes

Failed to decode audio

None

เกิดขึ้นเมื่อเซิร์ฟเวอร์ไม่สามารถถอดรหัสข้อมูลเสียงจากไบต์ได้

MissingAudioParam

Missing audio param!

None

เกิดขึ้นเมื่อไม่มีพารามิเตอร์ audio ที่จำเป็น

AudioTooBigForSync

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

stream_dir (str): ไดเรกทอรีหรือตำแหน่งของสตรีมเสียง

เกิดขึ้นเมื่อเสียงที่ระบุมีขนาดใหญ่เกินไปสำหรับการประมวลผลแบบซิงโครนัส

FailedToUseAudio

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

None

เกิดขึ้นเมื่อมีข้อผิดพลาดที่ไม่คาดคิดขณะประมวลผลเสียง

ข้อยกเว้นด้านการตรวจสอบสิทธิ์ (Authentication Exceptions)​

ข้อยกเว้น

ข้อความ

พารามิเตอร์

คำอธิบาย

NoTokenProvided

No session token provided

None

เกิดขึ้นเมื่อไม่มีการระบุโทเค็นเซสชัน

InvalidSessionToken

Invalid session token: {token}

token (str): โทเค็นเซสชันที่ไม่ถูกต้อง

เกิดขึ้นเมื่อมีการระบุโทเค็นเซสชันที่ไม่ถูกต้อง

UserDoesNotExist

Could not find {user_type} ID

user_type (str): ประเภทของ ID ผู้ใช้

เกิดขึ้นเมื่อไม่พบผู้ใช้ที่ระบุ

ClientIsNotActive

Client with {user_id} is not active

user_id (str): ID ผู้ใช้

เกิดขึ้นเมื่อไคลเอนต์ที่ระบุไม่ได้ใช้งาน

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): ID ผู้ใช้

เกิดขึ้นเมื่อไคลเอนต์ที่ระบุไม่มีสิทธิ์เข้าถึง API

ClientHasNoMoreMinutes

User has no remaining minutes

None

เกิดขึ้นเมื่อผู้ใช้ไม่มีนาทีคงเหลือสำหรับการใช้งาน API

คำขอที่มีสคริปต์ (Scripted Requests)​

คำขอที่มีสคริปต์เกี่ยวข้องกับเวิร์กโฟลว์หรือการดำเนินงานที่กำหนดไว้ล่วงหน้า ซึ่งดำเนินตามลำดับหรือสคริปต์ที่กำหนด คำขอเหล่านี้มักใช้ในสถานการณ์ที่ข้อมูลนำเข้าและผลลัพธ์ที่คาดหวังถูกกำหนดไว้อย่างชัดเจน เช่น การประมวลผลเสียงตามสคริปต์ที่กำหนดไว้ล่วงหน้า การดำเนินงานอัตโนมัติ หรือการจัดการเวิร์กโฟลว์แบบมีโครงสร้าง

ข้อยกเว้นด้านเสียง (Audio Exceptions)​

ข้อยกเว้น

ข้อความ

พารามิเตอร์

คำอธิบาย

MissingAudioParam

Missing audio param!

None

เกิดขึ้นเมื่อไม่มีพารามิเตอร์ audio ที่จำเป็น

FailedToReadAudioFromURL

Failed to read audio from the URL

None

เกิดขึ้นเมื่อเซิร์ฟเวอร์ไม่สามารถอ่านเสียงจาก URL ที่ระบุได้

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): รูปแบบของเสียงที่การแปลงล้มเหลว

เกิดขึ้นเมื่อเซิร์ฟเวอร์ไม่สามารถแปลงรูปแบบเสียงที่ระบุได้

FailedToUseAudio

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

None

เกิดขึ้นเมื่อมีข้อผิดพลาดที่ไม่คาดคิดขณะประมวลผลเสียง

ข้อยกเว้นด้านการตรวจสอบสิทธิ์ (Authentication Exceptions)​

ข้อยกเว้น

ข้อความ

พารามิเตอร์

คำอธิบาย

NoTokenProvided

No session token provided

None

เกิดขึ้นเมื่อไม่มีการระบุโทเค็นเซสชัน

ClientIsNotActive

Client with {user_id} is not active

user_id (str): ID ผู้ใช้

เกิดขึ้นเมื่อไคลเอนต์ที่ระบุไม่ได้ใช้งาน

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): ID ผู้ใช้

เกิดขึ้นเมื่อไคลเอนต์ที่ระบุไม่มีสิทธิ์เข้าถึง API

UserDoesNotExist

Could not find {user_type} ID

user_type (str): ประเภทของ ID ผู้ใช้

เกิดขึ้นเมื่อไม่พบผู้ใช้ที่ระบุ

InvalidHeaderParameter

A valid authorization header is required

None

เกิดขึ้นเมื่อส่วนหัวการอนุญาตไม่ถูกต้องหรือขาดหายไป