Listado de todas las voces

El método GET /v1/voices muestra información sobre todas las voces disponibles. No toma argumentos y devuelve una matriz JSON denominada voices. La matriz incluye un objeto distinto para cada voz. El orden en el que el servicio devuelve las voces puede variar de una llamada a otra. No se base en una lista de voces ordenada alfabéticamente o estática.

En el ejemplo siguiente se listan todas las voces que reciben soporte del servicio:

IBM Cloud

curl -X GET -u "apikey:{apikey}" \
"{url}/v1/voices"

IBM Cloud Pak for Data IBM Software Hub

curl -X GET \
--header "Authorization: Bearer {token}" \
"{url}/v1/voices"

Esta respuesta abreviada muestra solo las primeras pocas voces de la respuesta:

{
  "voices": [
    {
      "name": "en-US_LisaV3Voice",
      "language": "en-US",
      "gender": "female",
      "url": "{url}/v1/voices/en-US_LisaV3Voice",
      "customizable": true,
      "supported_features": {
        "voice_transformation": false,
        "custom_pronunciation": true
      },
      "description": "Lisa: American English female voice.",
    },
    {
      "name": "es-LA_SofiaV3Voice",
      "language": "es-LA",
      "customizable": true,
      "gender": "female",
      "url": "{url}/v1/voices/es-LA_SofiaV3Voice",
      "supported_features": {
        "voice_transformation": false,
        "custom_pronunciation": true
      },
      "description": "Sofia: Latin American Spanish (español latinoamericano) female voice."
    },
    {
      "name": "pt-BR_IsabelaV3Voice",
      "language": "pt-BR",
      "customizable": true,
      "gender": "female",
      "url": "{url}/v1/voices/pt-BR_IsabelaV3Voice",
      "supported_features": {
        "voice_transformation": false,
        "custom_pronunciation": true
      },
      "description": "Isabela: Brazilian Portuguese (português brasileiro) female voice."
    },
    . . .
  ]
}

Los campos de los objetos de voz proporcionan la información siguiente:

• name es un identificador de la voz (por ejemplo, en-US_LisaV3Voice). Especifique este valor para el parámetro voice del método /v1/synthesize.
• language especifica el idioma y la región de la voz (por ejemplo, en-US).
• gender identifica la voz como male (masculina) o female (femenina).
• url identifica el URL de la voz.
• description proporciona una breve descripción de la voz.
• customizable es un valor booleano que indica si la voz se puede personalizar con la interfaz de personalización del servicio. (Este campo, que proporciona la misma información que el campo custom_pronunciation, se mantiene para la compatibilidad con versiones anteriores).
• supported_features describe las características de servicio adicionales que admite la voz:
  • voice_transformation es un valor booleano que indica si la voz da soporte al elemento SSML <voice-transformation>. La función solo estaba disponible para voces estándar obsoletas en inglés estadounidense. No puede utilizar el elemento <voice-transformation> con ninguna voz soportada.
  • custom_pronunciation es un valor booleano que indica si la voz se puede personalizar con la interfaz de personalización del servicio.

Listar una voz específica

El método GET /v1/voices/{voice} muestra información sobre una voz específica. Acepta dos parámetros.

• voice (parámetro de vía de acceso, serie necesaria): identifica la voz para la que se debe devolver información. Para especificar una voz se utiliza su nombre (por ejemplo, en-US_LisaV3Voice).
• customization_id (parámetro de consulta, serie opcional): proporciona el identificador exclusivo global (GUID) de un modelo personalizado que se ha definido para el idioma de la voz especificada. Si incluye un ID de personalización, debe realizar la solicitud con las credenciales para la instancia del servicio que posee el modelo personalizado.

Si omite el parámetro customization_id, el método devuelve la salida JSON de la voz especificada que es idéntica a la información devuelta para una voz por el método GET /v1/voices. Si especifica un customization_id, la salida incluye un campo customization que proporciona información acerca del modelo personalizado especificado.

En el ejemplo siguiente se devuelve información sobre la voz en-US_LisaV3Voice y el modelo personalizado especificado:

IBM Cloud

curl -X GET -u "apikey:{apikey}" \
"{url}/v1/voices/en-US_LisaV3Voice?customization_id=64f4807f-a5f1-5867-924f-7bba1a84fe97"

IBM Cloud Pak for Data IBM Software Hub

curl -X GET \
--header "Authorization: Bearer {token}" \
"{url}/v1/voices/en-US_LisaV3Voice?customization_id=64f4807f-a5f1-5867-924f-7bba1a84fe97"

Los atributos del campo customization adicional proporcionan información de metadatos como el GUID, el nombre, el idioma y la descripción del modelo personalizado. También muestran las credenciales del propietario del modelo, la fecha y la hora en la que se ha creado el modelo y la fecha y la hora de su última modificación.

{
  "name": "en-US_LisaV3Voice",
  "language": "en-US",
  "gender": "female",
  "url": "{url}/v1/voices/en-US_LisaV3Voice",
  "description": "Lisa: American English female voice.",
  "customizable": true,
  "supported_features": {
    "voice_transformation": false,
    "custom_pronunciation": true
  },
  "customization": {
    "customization_id": "64f4807f-a5f1-5867-924f-7bba1a84fe97",
    "owner": "297cfd08-330a-22ba-93ce-1a73f454dd98",
    "created": "2017-09-16T17:12:31.743Z",
    "name": "Customization test",
    "language": "en-US",
    "description": "Customization test",
    "last_modified": "2017-09-16T17:12:31.743Z"
  }
}

Para ver las palabras personalizadas y las solicitudes que incluye el modelo, utilice el método GET /v1/customizations/{customization_id}. Para obtener más información, consulte Consulta de un modelo personalizado.