管理音箱型号

“示范调音”功能为测试版功能，仅支持美式英语定制车型和语音。

Tune by Example包括列出音箱型号、列出音箱型号的提示以及删除音箱型号的方法。它还包括创建扬声器模型的 POST /v1/speakers 方法；更多信息，请参阅创建扬声器模型。

列出所有扬声器型号

要列出为服务实例定义的所有扬声器型号，请使用 GET /v1/speakers 方法。该方法返回一个 speakers 数组，其中包含每个扬声器型号的以下信息：

speaker_id 表示发言者模型的全球唯一标识符（GUID）。 GUID用于在呼叫服务时识别发言者。
name 是创建扬声器模型时为用户指定的名称。

如果服务实例中没有定义任何扬声器型号，则数组为空。

列出所有发言者型号示例

以下示例返回指定服务凭证的所有可用扬声器型号：

IBM Cloud

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

IBM Cloud Pak for Data IBM Software Hub

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

资质证书包括两个发言者模型，speaker_one 和 speaker_two：

{
  "speakers": [
    {
      "speaker_id": "56367f89-546d-4b37-891e-4eb0c13cc833",
      "name": "speaker_one"
    },
    {
      "speaker_id": "323e4476-63de-9825-7cd7-8120e45f8331",
      "name": "speaker_two"
    }
  ]
}

列出扬声器的自定义提示

要列出与扬声器型号相关的所有自定义提示，请使用 GET /v1/speakers/{speaker_id} 方法。将所需扬声器型号的GUID传递给指定的路径参数。

该方法返回一个 customizations 数组，其中按 customization_id 列出了扬声器型号的所有自定义提示。对于每个自定义ID，该方法返回以下信息：

prompt 是用户指定的提示文本。
prompt_id 是用户指定的提示符。 ID用于识别服务呼叫中的提示。
status 是提示的当前状态：
- processing 表示服务已收到添加提示的请求，并正在处理该请求。
- available 表示服务已成功验证提示，现在可用于语音合成请求。
- failed 表示服务对提示的验证失败。提示信息中包含一个 error 字段，用于描述故障原因。

如果扬声器型号未关联任何自定义提示，则 customizations 数组为空。

列出扬声器型号的自定义提示示例

以下示例将返回与指定的 speaker_id 关联的所有自定义提示：

IBM Cloud

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

IBM Cloud Pak for Data IBM Software Hub

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

音箱型号与四个提示相关联，分为两个自定义型号：

{
  "customizations": [
    {
      "customization_id": "9937efc0-5341-b436-77e1-9923f6e693a1",
      "prompts": [
        {
          "prompt": "Hello and welcome!",
          "prompt_id": "greeting",
          "status": "available"
        },
        {
          "prompt": "How can I help you today?",
          "prompt_id": "help",
          "status": "processing"
        }
      ]
    },
    {
      "customization_id": "82f4809a-bf63-89a6-52ca-22731fe467ba",
      "prompts": [
        {
          "prompt": "Thank you and good-bye!",
          "prompt_id": "goodbye",
          "status": "available"
        },
        {
          "prompt": "I do not understand that response.",
          "prompt_id": "do_not_understand",
          "status": "available"
        }
      ]
    }
  ]
}

删除扬声器型号

要删除扬声器型号，请使用 DELETE /v1/speakers/{speaker_id} 方法。删除扬声器型号不会影响与已删除扬声器相关的任何提示。提示创建时，会确定提示质量的韵律数据。提示是静态的，不会因为相关发言者的删除而受到影响。但是，一旦原始发言者被删除，则无法重新提交或更新该提示。

删除发言者模型示例

以下示例将删除指定扬声器ID的扬声器模型：

IBM Cloud

curl -X DELETE -u "apikey:{apikey}" \
"{url}/v1/speakers/{speaker_id}"

IBM Cloud Pak for Data IBM Software Hub

curl -X DELETE \
--header "Authorization: Bearer {token}" \
"{url}/v1/speakers/{speaker_id}"