你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Transcriptions - Update

参考

服务:: Azure AI Services

API 版本:: v3.2-preview.2

更新由 ID 标识的听录的可变详细信息。

PATCH {endpoint}/speechtotext/v3.2-preview.2/transcriptions/{id}

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string	支持的认知服务终结点 (协议和主机名，例如： https://westus.api.cognitive.microsoft.com) 。
id	path	True	string uuid	听录的标识符。

请求正文

Media Types: "application/json", "application/merge-patch+json"

名称	类型	说明
customProperties	object	此实体的自定义属性。允许的最大密钥长度为 64 个字符，允许的最大值长度为 256 个字符，允许的条目计数为 10。
description	string	对象的说明。
displayName	string	对象的名称。
project	EntityReference	EntityReference

响应

名称	类型	说明
200 OK	Transcription	确定标头 Retry-After: integer
Other Status Codes	Error	出现了错误。

名称

类型

说明

200 OK

Transcription

确定

标头

Retry-After: integer

Other Status Codes

Error

出现了错误。

安全性

Ocp-Apim-Subscription-Key

在此处提供认知服务帐户密钥。

类型: apiKey
在: header

Authorization

提供此区域的 STS 返回的 JWT 的访问令牌。通过将以下查询字符串添加到 STS URL，确保将管理范围添加到令牌：？scope=speechservicesmanagement

类型: apiKey
在: header

示例

Update a transcription

示例请求

HTTP

PATCH {endpoint}/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683

{
  "displayName": "Updated transcription name",
  "description": "Updated transcription description",
  "customProperties": {
    "key": "value"
  }
}

示例响应

状态代码:: 200

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S"
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using adapted model en-US",
  "customProperties": {
    "key": "value"
  }
}

定义

名称	说明
DetailedErrorCode	DetailedErrorCode
DiarizationProperties	DiarizationProperties
DiarizationSpeakersProperties	DiarizationSpeakersProperties
EntityError	EntityError
EntityReference	EntityReference
Error	错误
ErrorCode	ErrorCode
InnerError	InnerError
LanguageIdentificationMode	LanguageIdentificationMode
LanguageIdentificationProperties	LanguageIdentificationProperties
ProfanityFilterMode	ProfanityFilterMode
PunctuationMode	PunctuationMode
Status	状态
Transcription	听录
TranscriptionLinks	TranscriptionLinks
TranscriptionProperties	TranscriptionProperties
TranscriptionUpdate	TranscriptionUpdate

DetailedErrorCode

名称	类型	说明
DataImportFailed	string	数据导入失败。
DeleteNotAllowed	string	不允许删除。
DeployNotAllowed	string	不允许部署。
DeployingFailedModel	string	部署失败的模型。
EmptyRequest	string	空请求。
EndpointCannotBeDefault	string	终结点不能为默认值。
EndpointNotUpdatable	string	终结点不可更新。
EndpointWithoutLogging	string	不记录的终结点。
ExceededNumberOfRecordingsUris	string	超出了录制 URI 数。
FailedDataset	string	失败的数据集。
Forbidden	string	已禁止。
InUseViolation	string	在使用中冲突。
InaccessibleCustomerStorage	string	无法访问的客户存储。
InvalidAdaptationMapping	string	无效的适应映射。
InvalidBaseModel	string	基本模型无效。
InvalidCallbackUri	string	无效的回调 URI。
InvalidCollection	string	无效的集合。
InvalidDataset	string	无效的数据集。
InvalidDocument	string	无效的文档。
InvalidDocumentBatch	string	无效的文档批处理。
InvalidLocale	string	区域设置无效。
InvalidLogDate	string	日志日期无效。
InvalidLogEndTime	string	日志结束时间无效。
InvalidLogId	string	日志 ID 无效。
InvalidLogStartTime	string	日志开始时间无效。
InvalidModel	string	无效的模型。
InvalidModelUri	string	模型 URI 无效。
InvalidParameter	string	参数无效。
InvalidParameterValue	string	参数值无效。
InvalidPayload	string	有效负载无效。
InvalidPermissions	string	权限无效。
InvalidPrerequisite	string	先决条件无效。
InvalidProductId	string	产品 ID 无效。
InvalidProject	string	无效的项目。
InvalidProjectKind	string	无效的项目类型。
InvalidRecordingsUri	string	录制 URI 无效。
InvalidRequestBodyFormat	string	请求正文格式无效。
InvalidSasValidityDuration	string	sas 有效性持续时间无效。
InvalidSkipTokenForLogs	string	日志的跳过令牌无效。
InvalidSourceAzureResourceId	string	源 Azure 资源 ID 无效。
InvalidSubscription	string	无效的订阅。
InvalidTest	string	测试无效。
InvalidTimeToLive	string	生存时间无效。
InvalidTopForLogs	string	日志顶部无效。
InvalidTranscription	string	听录无效。
InvalidWebHookEventKind	string	Web 挂钩事件类型无效。
MissingInputRecords	string	缺少输入记录。
ModelCopyOperationExists	string	模型复制操作存在。
ModelDeploymentNotCompleteState	string	模型部署未完成状态。
ModelDeprecated	string	模型已弃用。
ModelExists	string	模型存在。
ModelMismatch	string	模型不匹配。
ModelNotDeployable	string	模型不可部署。
ModelVersionIncorrect	string	模型版本不正确。
NoUtf8WithBom	string	没有具有 bom 的 utf8。
OnlyOneOfUrlsOrContainerOrDataset	string	只有一个 URL 或容器或数据集。
ProjectGenderMismatch	string	项目性别不匹配。
QuotaViolation	string	配额冲突。
SingleDefaultEndpoint	string	单个默认终结点。
SkuLimitsExist	string	存在 SKU 限制。
SubscriptionNotFound	string	找不到订阅。
UnexpectedError	string	意外错误。
UnsupportedClassBasedAdaptation	string	不支持的基于类的适应。
UnsupportedDelta	string	不支持的增量。
UnsupportedDynamicConfiguration	string	不支持的动态配置。
UnsupportedFilter	string	不支持的筛选器。
UnsupportedLanguageCode	string	不支持的语言代码。
UnsupportedOrderBy	string	不支持的订单。
UnsupportedPagination	string	不支持分页。
UnsupportedTimeRange	string	不支持的时间范围。

DiarizationProperties

名称	类型	说明
speakers	DiarizationSpeakersProperties	DiarizationSpeakersProperties

DiarizationSpeakersProperties

名称	类型	说明
maxCount	integer	要分割的最大说话人数。必须小于 36 且大于或等于 minSpeakers 属性。
minCount	integer	用于进行分割的最小说话人数的提示。必须小于或等于 maxSpeakers 属性。

EntityError

名称	类型	说明
code	string	此错误的代码。
message	string	此错误的消息。

EntityReference

名称	类型	说明
self	string	引用的实体的位置。

Error

错误

名称	类型	说明
code	ErrorCode	ErrorCode 高级错误代码。
details	Error[]	有关错误和/或预期策略的其他支持详细信息。
innerError	InnerError	InnerError 符合认知服务 API 指南 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow的新内部错误格式，请参阅。这包含必需的属性 ErrorCode、消息和可选属性目标、详细信息（键值对）、内部错误（可以嵌套）。
message	string	高级错误消息。
target	string	错误的源。例如，如果文档无效，应为“文档”或“文档 ID”。

ErrorCode

名称	类型	说明
Conflict	string	表示冲突错误代码。
Forbidden	string	表示禁止的错误代码。
InternalCommunicationFailed	string	表示内部通信失败的错误代码。
InternalServerError	string	表示内部服务器错误代码。
InvalidArgument	string	表示无效的参数错误代码。
InvalidRequest	string	表示无效的请求错误代码。
NotAllowed	string	表示不允许的错误代码。
NotFound	string	表示找不到的错误代码。
PipelineError	string	表示管道错误代码。
ServiceUnavailable	string	表示服务不可用的错误代码。
TooManyRequests	string	表示请求过多错误代码。
Unauthorized	string	表示未经授权的错误代码。
UnprocessableEntity	string	表示不可处理的实体错误代码。
UnsupportedMediaType	string	表示不受支持的媒体类型错误代码。

InnerError

名称	类型	说明
code	DetailedErrorCode	DetailedErrorCode 详细的错误代码枚举。
details	object	有关错误和/或预期策略的其他支持性详细信息。
innerError	InnerError	InnerError 新的内部错误格式，符合认知服务 API 指南，可从 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow获取。这包含必需的属性 ErrorCode、消息和可选属性目标、详细信息（键值对）、内部错误（可以嵌套）。
message	string	高级别错误消息。
target	string	错误的源。例如，如果文档无效，应为“文档”或“文档 ID”。

LanguageIdentificationMode

名称	类型	说明
Continuous	string	连续语言标识 (默认) 。
Single	string	单语言标识。

LanguageIdentificationProperties

名称	类型	默认值	说明
candidateLocales	string[]		语言标识的候选区域设置 (示例 [“en-US”， “de-DE”， “es-ES”]) 。支持至少 2 个和最多 10 个候选区域设置，包括听录的主要区域设置。
mode	LanguageIdentificationMode	Continuous	LanguageIdentificationMode 用于语言标识的模式。
speechModelMapping	<string, EntityReference>		区域设置到语音模型实体的可选映射。如果未为区域设置提供模型，则使用默认基本模型。键必须是候选区域设置中包含的区域设置，值是相应区域设置模型的实体。

ProfanityFilterMode

名称	类型	说明
Masked	string	用（第一个字母除外）屏蔽亵渎内容，例如 f**
None	string	禁用不雅内容筛选。
Removed	string	删除亵渎内容。
Tags	string	添加“不雅内容”XML 标记</不雅内容>

PunctuationMode

名称	类型	说明
Automatic	string	自动标点符号。
Dictated	string	仅听写标点符号，即显式标点符号。
DictatedAndAutomatic	string	听写标点符号或自动标点符号。
None	string	无标点符号。

Status

状态

名称	类型	说明
Failed	string	长时间运行的操作失败。
NotStarted	string	长时间运行的操作尚未启动。
Running	string	长时间运行的操作当前正在处理中。
Succeeded	string	长时间运行的操作已成功完成。

Transcription

听录

名称	类型	说明
contentContainerUrl	string	包含音频文件的 Azure Blob 容器的 URL。允许容器的最大大小为 5GB，最大数量为 10000 个 blob。 Blob 的最大大小为 2.5 GB。容器 SAS 应包含“r” (读取) 和“l” (列表) 权限。此属性不会在响应中返回。
contentUrls	string[]	用于获取要听录的音频文件的内容 URL 列表。最多允许 1000 个 URL。此属性不会在响应中返回。
createdDateTime	string	创建对象时的时间戳。时间戳编码为 ISO 8601 日期和时间格式 (“YYYY-MM-DDThh：mm：ssZ”，请参阅 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) 。
customProperties	object	此实体的自定义属性。允许的最大密钥长度为 64 个字符，允许的最大值长度为 256 个字符，允许的条目计数为 10。
dataset	EntityReference	EntityReference
description	string	对象的说明。
displayName	string	对象的显示名称。
lastActionDateTime	string	输入当前状态时的时间戳。时间戳编码为 ISO 8601 日期和时间格式 (“YYYY-MM-DDThh：mm：ssZ”，请参阅 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) 。
links	TranscriptionLinks	TranscriptionLinks
locale	string	包含数据的区域设置。如果使用语言标识，则此区域设置用于转录无法检测到任何语言的语音。
model	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	TranscriptionProperties	TranscriptionProperties
self	string	此实体的位置。
status	Status	状态描述 API 的当前状态

TranscriptionLinks

名称	类型	说明
files	string	获取此实体的所有文件的位置。有关更多详细信息，请参阅操作“Transcriptions_ListFiles”。

TranscriptionProperties

名称	类型	说明
channels	integer[]	请求的通道编号的集合。在默认情况下，考虑通道 0 和 1。
destinationContainerUrl	string	请求的目标容器。注解当目标容器与 `timeToLive`结合使用时，脚本的元数据将正常删除，但目标容器中存储的数据（包括听录结果）将保持不变，因为此容器不需要任何删除权限。若要支持自动清理，请在容器上配置 Blob 生存期，或使用“将自己的存储 (BYOS) ”，而不是 `destinationContainerUrl`（可在其中清理 blob）。
diarization	DiarizationProperties	DiarizationProperties
diarizationEnabled	boolean	一个值，该值指示是否请求) (说话人识别。默认值为 `false`。如果此字段设置为 true，并且通过指定 `DiarizationProperties`来配置改进的分割系统，则改进的分声系统将为可配置的扬声器范围提供二元化。如果此字段设置为 true，并且未启用改进的分割系统 (未指定 `DiarizationProperties`) ，则基本分割系统将区分最多两个扬声器。基本分割不收取额外的费用。基本分割系统已弃用，将在 API 的下一个主要版本中删除。此设置 `diarizationEnabled` 也将被删除。
displayFormWordLevelTimestampsEnabled	boolean	一个值，该值指示是否请求显示窗体的单词级别时间戳。默认值为 `false`。
duration	string	听录的持续时间。持续时间编码为 ISO 8601 持续时间 (“PnYnMnDTnHnMnS”，请参阅 https://en.wikipedia.org/wiki/ISO_8601#Durations) 。
email	string	要向其发送电子邮件通知的电子邮件地址，以防操作完成。成功发送电子邮件后，将删除该值。
error	EntityError	EntityError
languageIdentification	LanguageIdentificationProperties	LanguageIdentificationProperties
profanityFilterMode	ProfanityFilterMode	ProfanityFilterMode 亵渎内容筛选模式。
punctuationMode	PunctuationMode	PunctuationMode 用于标点的模式。
timeToLive	string	听录完成后，将在系统中保留多长时间。听录在完成 (成功或失败后到达生存时间后) 将自动删除。不设置此值或将其设置为 0 将禁用自动删除。支持的最长持续时间为 31 天。持续时间编码为 ISO 8601 持续时间 (“PnYnMnDTnHnMnS”，请参阅 https://en.wikipedia.org/wiki/ISO_8601#Durations) 。
wordLevelTimestampsEnabled	boolean	一个值，该值指示是否请求单词级别时间戳。默认值为 `false`。

TranscriptionUpdate

名称	类型	说明
customProperties	object	此实体的自定义属性。允许的最大密钥长度为 64 个字符，允许的最大值长度为 256 个字符，允许的条目计数为 10。
description	string	对象的说明。
displayName	string	对象的名称。
project	EntityReference	EntityReference

通过

Transcriptions - Update

URI 参数

请求正文

响应

安全性

Ocp-Apim-Subscription-Key

Authorization

示例

Update a transcription

示例请求

示例响应

定义

DetailedErrorCode

DiarizationProperties

DiarizationSpeakersProperties

EntityError

EntityReference

Error

ErrorCode

InnerError

LanguageIdentificationMode

LanguageIdentificationProperties

ProfanityFilterMode

PunctuationMode

Status

Transcription

TranscriptionLinks

TranscriptionProperties

注解

TranscriptionUpdate

其他资源