创建批量听录

若要创建听录，请使用语音转文本 REST API 的 Transcriptions_Create 操作。 根据以下说明构造请求正文：

• 必须设置 contentContainerUrl 或 contentUrls 属性。 有关适用于批量听录的 Azure blob 存储的详细信息，请参阅找到批量听录的音频文件。
• 设置所需的 locale 属性。 此值应与要听录的音频数据的预期区域设置相匹配。 之后无法更改区域设置。
• 设置所需的 displayName 属性。 选择稍后可以引用的听录名称。 听录名称不必是独一无二的，以后可以更改。
• （可选）若要使用基础模型以外的模型，请将 model 属性设置为模型 ID。 有关详细信息，请参阅使用自定义模型。
• （可选）将 wordLevelTimestampsEnabled 属性设置为 true 以在听录结果中启用单词级时间戳。 默认值为 false。
• （可选）设置 languageIdentification 属性。 语言标识用于在与支持的语言列表比较时确定音频中所说的语言。 如果设置 languageIdentification 属性，则还必须使用候选区域设置设定 languageIdentification.candidateLocales。

有关详细信息，请参阅请求配置选项。

发出使用 URI 的 HTTP POST 请求，如以下 Transcriptions_Create 示例所示。

• 将 YourSubscriptionKey 替换为语音资源密钥。
• 将 YourServiceRegion 替换为你所在的语音资源区域。
• 如前文所述，设置请求正文属性。

curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
  "contentUrls": [
    "https://crbn.us/hello.wav",
    "https://crbn.us/whatstheweatherlike.wav"
  ],
  "locale": "en-US",
  "displayName": "My Transcription",
  "model": null,
  "properties": {
    "wordLevelTimestampsEnabled": true,
    "languageIdentification": {
      "candidateLocales": [
        "en-US", "de-DE", "es-ES"
      ],
    }
  },
}'  "https://YourServiceRegion.api.cognitive.azure.cn/speechtotext/v3.1/transcriptions"

你应该会收到以下格式的响应正文：

{
  "self": "https://chinanorth2.api.cognitive.azure.cn/speechtotext/v3.1/transcriptions/db474955-ab85-4c6c-ba6e-3bfe63d041ba",
  "model": {
    "self": "https://chinanorth2.api.cognitive.azure.cn/speechtotext/v3.1/models/base/13fb305e-09ad-4bce-b3a1-938c9124dda3"
  },
  "links": {
    "files": "https://chinanorth2.api.cognitive.azure.cn/speechtotext/v3.1/transcriptions/db474955-ab85-4c6c-ba6e-3bfe63d041ba/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": true,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "languageIdentification": {
      "candidateLocales": [
        "en-US",
        "de-DE",
        "es-ES"
      ]
    }
  },
  "lastActionDateTime": "2022-10-21T14:18:06Z",
  "status": "NotStarted",
  "createdDateTime": "2022-10-21T14:18:06Z",
  "locale": "en-US",
  "displayName": "My Transcription"
}

响应正文中的顶级 self 属性是听录的 URI。 使用此 URI 可获取详细信息，例如听录和听录报告文件的 URI。 还可以使用此 URI 来更新或删除听录。

可以通过 Transcriptions_Get 操作查询听录的状态。

检索结果后，请定期从服务中调用 Transcriptions_Delete。 或者，设置 timeToLive 属性以确保最终删除结果。

若要创建听录，请使用 spx batch transcription create 命令。 根据以下说明构造请求参数：

• 设置所需的 content 参数。 可以指定一系列由分号分隔的单个文件，或指定整个容器的 URL。 有关适用于批量听录的 Azure blob 存储的详细信息，请参阅找到批量听录的音频文件。
• 设置所需的 language 属性。 此值应与要听录的音频数据的预期区域设置相匹配。 之后无法更改区域设置。 语音 CLI language 参数对应于 JSON 请求和响应中的 locale 属性。
• 设置所需的 name 属性。 选择稍后可以引用的听录名称。 听录名称不必是独一无二的，以后可以更改。 语音 CLI name 参数对应于 JSON 请求和响应中的 displayName 属性。

下面是创建听录作业的语音 CLI 命令的示例：

spx batch transcription create --name "My Transcription" --language "en-US" --content https://crbn.us/hello.wav;https://crbn.us/whatstheweatherlike.wav

你应该会收到以下格式的响应正文：

{
  "self": "https://chinanorth2.api.cognitive.azure.cn/speechtotext/v3.1/transcriptions/7f4232d5-9873-47a7-a6f7-4a3f00d00dc0",
  "model": {
    "self": "https://chinanorth2.api.cognitive.azure.cn/speechtotext/v3.1/models/base/13fb305e-09ad-4bce-b3a1-938c9124dda3"
  },
  "links": {
    "files": "https://chinanorth2.api.cognitive.azure.cn/speechtotext/v3.1/transcriptions/7f4232d5-9873-47a7-a6f7-4a3f00d00dc0/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked"
  },
  "lastActionDateTime": "2022-10-21T14:21:59Z",
  "status": "NotStarted",
  "createdDateTime": "2022-10-21T14:21:59Z",
  "locale": "en-US",
  "displayName": "My Transcription",
  "description": ""
}

响应正文中的顶级 self 属性是听录的 URI。 使用此 URI 可获取详细信息，例如听录和听录报告文件的 URI。 还可以使用此 URI 来更新或删除听录。

若要获取听录的语音 CLI 帮助，请运行以下命令：

spx help batch transcription

下面是一些属性选项，可用于在调用 Transcriptions_Create 操作时配置听录。

若要获取听录配置选项的语音 CLI 帮助，请运行以下命令：

spx help batch transcription create advanced

curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
  "contentUrls": [
    "https://crbn.us/hello.wav",
    "https://crbn.us/whatstheweatherlike.wav"
  ],
  "locale": "en-US",
  "displayName": "My Transcription",
  "model": {
    "self": "https://chinanorth2.api.cognitive.azure.cn/speechtotext/v3.1/models/base/1aae1070-7972-47e9-a977-87e3b05c457d"
  },
  "properties": {
    "wordLevelTimestampsEnabled": true,
  },
}'  "https://YourServiceRegion.api.cognitive.azure.cn/speechtotext/v3.1/transcriptions"

spx batch transcription create --name "My Transcription" --language "en-US" --content https://crbn.us/hello.wav;https://crbn.us/whatstheweatherlike.wav --model "https://chinanorth.api.cognitive.azure.cn/speechtotext/v3.1/models/base/1aae1070-7972-47e9-a977-87e3b05c457d"