模型信息

无论您列示有关所有可用模型的信息还是有关特定模型的信息，该服务都将返回模型的相同输出:

• name 是在请求中使用的模型的名称。

• language 是模型的语言标识（例如，en-US）。

• rate 标识与模型一起使用的音频的最小可接受采样率 (以赫兹为单位)。

• url 是模型的 URI。

• description 提供模型的简要描述。

• supported_features 描述模型支持的其他服务功能：

  • custom_language_model 是布尔值，指示是否可以创建基于模型的定制语言模型。
  • IBM Cloud custom_acoustic_model 是一个布尔值，用于指示您是否可以创建基于该模型的定制声学模型。
  • low_latency 是一个布尔值，用于指示您是否可以将 low_latency 参数与下一代模型配合使用。 该服务仅针对下一代模型包含此字段。 大型语音模型和前代模型不支持 low_latency 参数。
  • speaker_labels 指示是否可以将 speaker_labels 参数用于模型。

  对于所有模型，speaker_labels 字段都会返回 true。 但是，仅对有限数量的语言支持说话者标签作为 Beta 功能。 有关更多信息，请参阅说话者标签。

列出所有模型

您使用 HTTP GET /v1/models 方法列出所有可用型号的信息。 此服务返回 JSON 对象的数组，这些对象提供有关所有模型的信息。

服务返回模型的顺序因不同调用而有所不同。 因此，不要依赖按字母顺序排列或静态的车型列表。 由于模型是作为 JSON 对象的数组返回的，因此顺序对响应的计划性用途没有影响。

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

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

{
  "models": [
    {
      "name": "pt-BR_NarrowbandModel",
      "language": "pt-BR",
      "url": "{url}/v1/models/pt-BR_NarrowbandModel",
      "rate": 8000,
      "supported_features": {
        "custom_language_model": true,
        "custom_acoustic_model": true,
        "speaker_labels": true
      },
      "description": "Brazilian Portuguese narrowband model."
    },
    {
      "name": "ko-KR_BroadbandModel",
      "language": "ko-KR",
      "url": "{url}/v1/models/ko-KR_BroadbandModel",
      "rate": 16000,
      "supported_features": {
        "custom_language_model": true,
        "custom_acoustic_model": true,
        "speaker_labels": true
      },
      "description": "Korean broadband model."
    },
    {
      "name": "fr-FR_BroadbandModel",
      "language": "fr-FR",
      "url": "{url}/v1/models/fr-FR_BroadbandModel",
      "rate": 16000,
      "supported_features": {
        "custom_language_model": true,
        "custom_acoustic_model": true,
        "speaker_labels": true
      },
      "description": "French broadband model."
    },
    . . .
  ]
}

列出特定模型

您可以使用 HTTP GET /v1/models/{model_id} 方法列出指定车型的相关信息。 该服务仅返回该模型的信息。

curl -X GET -u "apikey:{apikey}" \
"{url}/v1/models/en-US_BroadbandModel"

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

{
  "rate": 16000,
  "name": "en-US_BroadbandModel",
  "language": "en-US",
  "url": "{url}/v1/models/en-US_BroadbandModel",
  "supported_features": {
    "custom_language_model": true,
    "custom_acoustic_model": true,
    "speaker_labels": true
  },
  "description": "US English broadband model."
}

curl -X GET -u "apikey:{apikey}" \
"{url}/v1/models/en-US_Telephony"

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

{
   "name": "en-US_Telephony",
   "rate": 8000,
   "language": "en-US",
   "description": "US English telephony model for narrowband audio (8kHz)",
   "supported_features": {
      "custom_language_model": true,
      "custom_acoustic_model": false,
      "low_latency": true,
      "speaker_labels": true
   },
   "url": "{url}/v1/models/en-US_Telephony"
}

curl -X GET -u "apikey:{apikey}" \
"{url}/v1/models/en-US"

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

{
  "name": "en-US",
  "rate": 8000,
  "language": "en-US",
  "description": "Large US English model",
  "supported_features": {
    "custom_language_model": true,
    "custom_acoustic_model": false,
    "low_latency": false,
    "speaker_labels": true
    },
  "url": "{url}/v1/models/en-US"
}