Push-to-Speech API

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

การตรวจสอบสิทธิ์

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ส่วนภาพรวม REST API ในวิธีการตรวจสอบสิทธิ์

สร้าง/อัปเดตการกระจายเสียงด้วยเสียง

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

ที่อยู่ API

              
              POST v4/voices

            

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

ส่วนหัวของคำขอ

              
              POST /v4/voices
Authorization: Basic (base64 auth string)
Content-Type: multipart/form-data
Accept: multipart/form-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 เพื่อการรวมระบบที่ถูกต้อง

รับรายการการกระจายเสียงด้วยเสียง

ที่อยู่ API

GET v4/voices

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

ส่วนหัวของคำขอ

              
              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

รับรายละเอียดการกระจายเสียงด้วยเสียง

ที่อยู่ API

GET v4/voices/{language}

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

ส่วนหัวของคำขอ

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

            

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

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

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

            

ข้อมูลการตอบกลับ

              
              {
   "file_url": ""
}

            

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

ลบไฟล์เสียง

ที่อยู่ API

DELETE v4/voices/{language}

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

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

            

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

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

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

            

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

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

              
              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": 28400,
        "message": "error message"
    }
}

            

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