API Push-to-Speech

Remarque : Les diffusions vocales créées via cette API peuvent uniquement être récupérées, modifiées ou supprimées via l'API.
Remarque : Les langues actuellement prises en charge pour les fichiers vocaux sont uniquement « en », « zh-Hans » et « zh-Hant ».

Authentification

Pour plus de détails, reportez-vous à la section Authentication Method dans la vue d’ensemble de l’API REST.

Créer/Mettre à jour une diffusion vocale

Si la diffusion vocale n’existe pas, elle sera créée. Si elle existe déjà, elle sera mise à jour.

Endpoint

              
              POST v4/voices

            

Exemple de requête

En-têtes de requête

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

            

Données de requête

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

            

Description des données de requête

• language : spécifie la langue du fichier de diffusion vocale et est utilisé pour sélectionner la langue de diffusion vocale requise par l’utilisateur.
• file : le fichier ZIP utilisé pour la diffusion vocale, contenant tous les fichiers MP3 requis.

Exemple de réponse

Réponse réussie

              
              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 : l’URL de téléchargement du fichier téléversé dans Huawei Cloud OBS.

Réponse d’échec

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

            

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

            

Description du format des fichiers vocaux

Les fichiers de diffusion vocale pris en charge par cette API doivent être nommés selon les nombres et mots spécifiés, et chaque fichier doit utiliser le format .mp3. Les conventions de nommage suivantes sont prises en charge :

• Anglais (en) :

  • Nombres : "0" à "20", "30", "40", "50", "60", "70", "80", "90", "100", "1000", "1000000", "1000000000"
  • Mots : "point", "and"

• Chinois (zh) :

  • Nombres : "0" à "10", "100", "1000", "10000", "100000000"
  • Mots : "point"

Assurez-vous que tous les fichiers sont au format MP3 afin de garantir une intégration correcte au système.

Obtenir la liste des diffusions vocales

Endpoint

GET v4/voices

Exemple de requête

En-têtes de requête

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

            

• Règle de tri : tri par heure de mise à jour, de la plus récente à la plus ancienne.

Exemple de réponse

Réponse réussie

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

            

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

            

• Retourne une liste des diffusions vocales valides de cette application.
• Le language retourné est la langue demandée par le client lors de la création ou de la mise à jour.
• Le file_url retourné est l’URL de téléchargement Huawei Cloud OBS correspondant au fichier téléversé par le client lors de la création ou de la mise à jour.

Obtenir les détails d’une diffusion vocale

Endpoint

GET v4/voices/{language}

Exemple de requête

En-têtes de requête

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

            

Exemple de réponse

Réponse réussie

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

            

Données de réponse

              
              {
  "file_url": ""
}

            

• Si la langue n’existe pas, 404 est renvoyé. Sinon, le file_url effectivement renvoyé est l’URL de téléchargement Huawei Cloud OBS correspondant au fichier téléversé.

Supprimer un fichier vocal

Endpoint

DELETE v4/voices/{language}

Exemple de requête

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

            

Exemple de réponse

Réponse réussie

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

            

Réponse d’échec

• Langue invalide ou langue inexistante.

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

            

• Opération de mise à jour invalide.

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

            

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

            

Codes d’erreur