Push-to-Speech API

Hinweis: Sprachübertragungen, die über diese API erstellt werden, können ausschließlich über die API abgerufen, bearbeitet oder gelöscht werden. Hinweis: Derzeit werden als Sprachdateityp nur die Sprachen „en“, „zh-Hans“, „zh-Hant“ unterstützt.

Authentifizierung

Weitere Informationen finden Sie im Abschnitt zur REST-API-Übersicht unter Authentifizierungsmethoden.

Sprachübertragung erstellen/aktualisieren

Erstellt eine neue Sprachübertragung, falls diese noch nicht existiert; andernfalls wird sie aktualisiert.

Endpoint

              
              POST v4/voices

            

Beispielanfrage

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"'

            

Beschreibung der Request-Daten

• language: Gibt die Sprache der Sprachübertragungsdatei an und dient zur Auswahl der benötigten Sprache.
• file: Die für die Sprachübertragung benötigte ZIP-Datei, die alle erforderlichen MP3-Dateien enthält.

Beispiel für eine erfolgreiche Antwort

              
              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: Die Download-URL der hochgeladenen Datei auf Huawei Cloud OBS.

Fehlerhafte Antwort

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

            

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

            

Spezifikationen für Audiodateien

Die Audiodateien für diese API müssen gemäß den angegebenen Zahlen und Wörtern benannt werden, wobei jedes Dateiformat .mp3 sein muss. Nachfolgend die unterstützten Benennungsdetails:

• Englisch (en):

  • Zahlen: „0“ bis „20“, „30“, „40“, „50“, „60“, „70“, „80“, „90“, „100“, „1000“, „1000000“, „1000000000“
  • Wörter: „point“, „and“

• Chinesisch (zh):

  • Zahlen: „0“ bis „10“, „100“, „1000“, „10000“, „100000000“
  • Wörter: „point“

Stellen Sie sicher, dass alle Dateien im MP3-Format vorliegen, um eine korrekte Systemintegration zu gewährleisten.

Sprachübertragungsliste abrufen

Endpoint

GET v4/voices

Beispielanfrage

Request Headers

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

            

• Sortierreihenfolge: Neueste Aktualisierungen zuerst.

Beispiel für eine erfolgreiche Antwort

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

            

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

            

• Gibt die Liste der gültigen Sprachübertragungen für die jeweilige Anwendung zurück.
• language entspricht der bei Erstellung/Aktualisierung angegebenen Sprache.
• file_url ist die Download-URL der hochgeladenen Datei auf Huawei Cloud OBS.

Details einer Sprachübertragung abrufen

Endpoint

GET v4/voices/{language}

Beispielanfrage

Request Headers

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

            

Beispiel für eine erfolgreiche Antwort

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

            

Antwortdaten

              
              {
   "file_url": ""
}

            

• Falls language nicht existiert, wird 404 zurückgegeben, andernfalls wird die tatsächliche file_url zurückgegeben, also die Download-URL der hochgeladenen Datei auf Huawei Cloud OBS.

Sprachdatei löschen

Endpoint

DELETE v4/voices/{language}

Beispielanfrage

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

            

Beispiel für eine erfolgreiche Antwort

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

            

Fehlerhafte Rückgabe

• Wenn language ungültig ist oder nicht existiert.

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

            

• Wenn die Aktualisierungsoperation unzulässig ist.

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

            

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

            

Fehlercodes