API แปลงข้อความเป็นเสียง

หมายเหตุ: การออกอากาศเสียงที่สร้างผ่าน API นี้ สามารถดึงข้อมูล แก้ไข หรือลบได้ผ่าน API เท่านั้น
หมายเหตุ: ปัจจุบันภาษาที่รองรับสำหรับไฟล์เสียงมีเพียง "en", "zh-Hans" และ "zh-Hant" เท่านั้น

การยืนยันตัวตน

สำหรับรายละเอียดเพิ่มเติม โปรดดูส่วน วิธีการยืนยันตัวตน ในภาพรวม REST API

สร้าง/อัปเดตการออกอากาศเสียง

หากยังไม่มีการออกอากาศเสียง ระบบจะสร้างใหม่ หากมีอยู่แล้ว ระบบจะอัปเดต

Endpoint

              
              POST v4/voices

            

ตัวอย่างคำขอ

Request Headers

              
              POST /v4/voices
Authorization: Basic (base64 auth string)
Content-Type: multipart/form-data
Accept: multipart/form-data

            

Request Data

              
              --form 'language="en"'
--form 'file="file"'

            

คำอธิบายข้อมูลคำขอ

• language: ระบุภาษาของไฟล์การออกอากาศเสียง และใช้เพื่อเลือกภาษาการออกอากาศเสียงที่ผู้ใช้ต้องการ
• file: ไฟล์ ZIP ที่ใช้สำหรับการออกอากาศเสียง ซึ่งประกอบด้วยไฟล์ MP3 ที่จำเป็นทั้งหมด

ตัวอย่างการตอบกลับ

การตอบกลับเมื่อสำเร็จ

              
              HTTP/1.1 200 OK
Server: fasthttp
Date: Thu, 01 Dec 2022 07:17:45 GMT
Content-Type: application/json
Content-Length: 85

            

              
              {
  "file_url": ""
}

            

• file_url: URL สำหรับดาวน์โหลดไฟล์ที่อัปโหลดไปยัง Huawei Cloud OBS

การตอบกลับเมื่อล้มเหลว

              
              HTTP/1.1 400 BAD REQUEST
Content-Type: application/json; charset=utf-8

            

              
              {
  "error": {
    "code": 28400,
    "message": "error message"
  }
}

            

คำอธิบายรูปแบบไฟล์เสียง

ไฟล์การออกอากาศเสียงที่ API นี้รองรับต้องตั้งชื่อตามตัวเลขและคำที่กำหนด และแต่ละไฟล์ต้องอยู่ในรูปแบบ .mp3 โดยรองรับรูปแบบการตั้งชื่อดังต่อไปนี้:

• ภาษาอังกฤษ (en):

  • ตัวเลข: "0" ถึง "20", "30", "40", "50", "60", "70", "80", "90", "100", "1000", "1000000", "1000000000"
  • คำ: "point", "and"

• ภาษาจีน (zh):

  • ตัวเลข: "0" ถึง "10", "100", "1000", "10000", "100000000"
  • คำ: "point"

โปรดตรวจสอบให้แน่ใจว่าไฟล์ทั้งหมดอยู่ในรูปแบบ MP3 เพื่อให้ระบบสามารถทำงานร่วมกันได้อย่างถูกต้อง

รับรายการการออกอากาศเสียง

Endpoint

GET v4/voices

ตัวอย่างคำขอ

Request Headers

              
              GET /v4/voices
Authorization: Basic (base64 auth string)

            

• กฎการจัดเรียง: เรียงตามเวลาอัปเดต โดยแสดงรายการล่าสุดก่อน

ตัวอย่างการตอบกลับ

การตอบกลับเมื่อสำเร็จ

              
              HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

            

              
              [
  {
    "language": "en",
    "file_url": ""
  }
]

            

• ส่งคืนรายการการออกอากาศเสียงที่พร้อมใช้งานภายใต้แอปพลิเคชันนี้
• ค่า language ที่ส่งคืนคือภาษาที่ไคลเอนต์ร้องขอระหว่างการสร้างหรืออัปเดต
• ค่า file_url ที่ส่งคืนคือ URL สำหรับดาวน์โหลดจาก Huawei Cloud OBS ซึ่งสอดคล้องกับไฟล์ที่ไคลเอนต์อัปโหลดระหว่างการสร้างหรืออัปเดต

รับรายละเอียดการออกอากาศเสียง

Endpoint

GET v4/voices/{language}

ตัวอย่างคำขอ

Request Headers

              
              GET /v4/voices/en
Authorization: Basic (base64 auth string)

            

ตัวอย่างการตอบกลับ

การตอบกลับเมื่อสำเร็จ

              
              HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

            

Response Data

              
              {
  "file_url": ""
}

            

• หากไม่มีภาษานี้ ระบบจะส่งคืน 404 มิฉะนั้น file_url ที่ส่งคืนจะเป็น URL สำหรับดาวน์โหลดจาก Huawei Cloud OBS ซึ่งสอดคล้องกับไฟล์ที่อัปโหลด

ลบไฟล์เสียง

Endpoint

DELETE v4/voices/{language}

ตัวอย่างคำขอ

              
              DELETE /v4/voices/en
Authorization: Basic (base64 auth string)

            

ตัวอย่างการตอบกลับ

การตอบกลับเมื่อสำเร็จ

              
              HTTP/1.0 200
Content-Type: application/json
Content-Length: 0

            

การตอบกลับเมื่อล้มเหลว

• ภาษาไม่ถูกต้อง หรือไม่มีภาษานี้อยู่

              
              HTTP/1.0 404 Not Found
Content-Type: application/json

            

• การดำเนินการอัปเดตไม่ถูกต้อง

              
              HTTP/1.1 400 BAD REQUEST
Content-Type: application/json; charset=utf-8

            

              
              {
  "error": {
    "code": 23903,
    "message": "voice does not exist"
  }
}

            

รหัสข้อผิดพลาด