Transcriptions - Submit

Служба:: Azure AI Services

Версия API:: 2025-10-15

Отправляет новое задание на транскрибирование.

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2025-10-15

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string	Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например: https://westus.api.cognitive.microsoft.com).
api-version	query	True	string	Запрашиваемая версия api.

Заголовок запроса

Имя	Обязательно	Тип	Описание
Ocp-Apim-Subscription-Key	True	string	Укажите ключ учетной записи Cognitive Services здесь.

Текст запроса

Имя	Обязательно	Тип	Описание
displayName	True	string minLength: 1	Отображаемое имя объекта.
locale	True	string minLength: 1	Языковой стандарт содержащихся данных. Если используется идентификация языка, этот языковой стандарт используется для транскрибирования речи, для которой не удалось обнаружить язык.
properties	True	TranscriptionProperties	ТранскрибированиеProperties
contentContainerUrl		string (uri)	URL-адрес контейнера BLOB-объектов Azure, содержащего аудиофайлы. Контейнер может иметь максимальный размер 5 ГБ и максимальное количество 10000 больших двоичных объектов. Максимальный размер большого двоичного объекта составляет 2,5 ГБ. Контейнер SAS должен содержать разрешения 'r' (чтение) и 'l' (список). Это свойство не будет возвращено в ответе.
contentUrls		string[] (uri)	Список URL-адресов содержимого для расшифровки аудиофайлов. Допускается до 1000 URL. Это свойство не будет возвращено в ответе.
customProperties		object	Пользовательские свойства этой сущности. Максимально допустимая длина ключа — 64 символа, максимально допустимая длина значения — 256 символов, а количество разрешенных записей — 10.
dataset		EntityReference	EntityReference
description		string	Описание объекта.
model		EntityReference	EntityReference
project		EntityReference	EntityReference

Ответы

Имя	Тип	Описание
201 Created	Transcription	Ответ содержит информацию о сущности в виде полезных данных и ее расположении в виде заголовка. Заголовки Location: string
Other Status Codes	Error	Произошла ошибка.

Имя

Тип

Описание

201 Created

Transcription

Ответ содержит информацию о сущности в виде полезных данных и ее расположении в виде заголовка.

Заголовки

Location: string

Other Status Codes

Error

Произошла ошибка.

Безопасность

Ocp-Apim-Subscription-Key

Укажите ключ учетной записи Cognitive Services здесь.

Тип: apiKey
В: header

Примеры

Create a transcription for URIs

Create a transcription from blob container

Create a transcription with language identification

Create a transcription with multispeaker diarization

Create a transcription for URIs

Образец запроса

HTTP

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2025-10-15


{
  "displayName": "Transcription using default model for en-US",
  "locale": "en-US",
  "contentUrls": [
    "https://contoso.com/mystoragelocation",
    "https://contoso.com/myotherstoragelocation"
  ],
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48
  }
}

Пример ответа

Код состояния:: 201

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

Create a transcription from blob container

Образец запроса

HTTP

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2025-10-15


{
  "displayName": "Transcription of storage container using default model for en-US",
  "locale": "en-US",
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48
  },
  "contentContainerUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/audiofiles/"
}

Пример ответа

Код состояния:: 201

Location: https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683?api-version=2025-10-15

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

Create a transcription with language identification

Образец запроса

HTTP

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2025-10-15


{
  "displayName": "Transcription using language identification with three candidate languages, 'fr-FR' as fallback locale and a custom model for transcribing utterances that were classified as 'nl-NL' locale.",
  "locale": "fr-FR",
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48,
    "languageIdentification": {
      "candidateLocales": [
        "fr-FR",
        "nl-NL",
        "el-GR"
      ],
      "speechModelMapping": {
        "nl-NL": {
          "self": "https://westus.api.cognitive.microsoft.com/speechtotext/models/827712a5-f942-4997-91c3-7c6cde35600b?api-version=2025-10-15"
        }
      },
      "mode": "Single"
    }
  }
}

Пример ответа

Код состояния:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683?api-version=2025-10-15",
  "displayName": "Transcription using language identification with three candidate languages, 'fr-FR' as fallback locale and a custom model for transcribing utterances that were classified as 'nl-NL' locale.",
  "customProperties": {
    "key": "value"
  },
  "locale": "fr-FR",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/models/827712a5-f942-4997-91c3-7c6cde35600b?api-version=2025-10-15"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?api-version=2025-10-15"
  },
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48,
    "languageIdentification": {
      "candidateLocales": [
        "fr-FR",
        "nl-NL",
        "el-GR"
      ],
      "speechModelMapping": {
        "nl-NL": {
          "self": "https://westus.api.cognitive.microsoft.com/speechtotext/models/827712a5-f942-4997-91c3-7c6cde35600b?api-version=2025-10-15"
        }
      },
      "mode": "Single"
    },
    "durationMilliseconds": 42000
  },
  "status": "Succeeded"
}

Create a transcription with multispeaker diarization

Образец запроса

HTTP

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2025-10-15


{
  "displayName": "Transcription using diarization for audio that is known to contain speech from up to 5 speakers",
  "locale": "en-US",
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48,
    "diarization": {
      "enabled": true,
      "maxSpeakers": 5
    }
  }
}

Пример ответа

Код состояния:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683?api-version=2025-10-15",
  "displayName": "Transcription using diarization for audio that is known to contain speech from up to 5 speakers",
  "customProperties": {
    "key": "value"
  },
  "locale": "en-US",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/models/827712a5-f942-4997-91c3-7c6cde35600b?api-version=2025-10-15"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?api-version=2025-10-15"
  },
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48,
    "diarization": {
      "enabled": true,
      "maxSpeakers": 5
    },
    "durationMilliseconds": 42000
  },
  "status": "Succeeded"
}

Определения

Имя	Описание
DetailedErrorCode	ДетальныйКод ошибки
DiarizationProperties	DiarizationProperties
EntityError	EntityError (Ошибка сущности)
EntityReference	EntityReference
Error	Ошибка
ErrorCode	ErrorCode
InnerError	InnerError
LanguageIdentificationMode	Режим идентификации языка
LanguageIdentificationProperties	LanguageIdentificationProperties
ProfanityFilterMode	Ненормативная лексикаFilterMode
PunctuationMode	Знак препинанияMode
Status	Состояние
Transcription	Расшифровка
TranscriptionLinks	ТранскрипцияСсылки
TranscriptionProperties	ТранскрибированиеProperties

DetailedErrorCode

Перечисление

ДетальныйКод ошибки

Значение	Описание
InvalidParameterValue	Недопустимое значение параметра.
InvalidRequestBodyFormat	Недопустимый формат тела запроса.
EmptyRequest	Пустой запрос.
MissingInputRecords	Отсутствуют входные записи.
InvalidDocument	Недействительный документ.
ModelVersionIncorrect	Версия модели неверна.
InvalidDocumentBatch	Недопустимый пакет документа.
UnsupportedLanguageCode	Неподдерживаемый языковой код.
DataImportFailed	Не удалось импортировать данные.
InUseViolation	В использовании нарушение.
InvalidLocale	Недопустимая локаль.
InvalidBaseModel	Недопустимая базовая модель.
InvalidAdaptationMapping	Неверное адаптационное отображение.
InvalidDataset	Недопустимый набор данных.
InvalidTest	Неверный тест.
FailedDataset	Неудачный набор данных.
InvalidModel	Неверная модель.
InvalidTranscription	Неверная транскрипция.
InvalidPayload	Неверная полезная нагрузка.
InvalidParameter	Недопустимый параметр.
EndpointWithoutLogging	Конечная точка без логирования.
InvalidPermissions	Недействительные разрешения.
InvalidPrerequisite	Неверное предварительное условие.
InvalidProductId	Неверный идентификатор товара.
InvalidSubscription	Недействительная подписка.
InvalidProject	Неверный проект.
InvalidProjectKind	Недопустимый вид проекта.
InvalidRecordingsUri	Недействительные записи uri.
OnlyOneOfUrlsOrContainerOrDataset	Только один из url, контейнеров или наборов данных.
ExceededNumberOfRecordingsUris	Превышено количество записей uri.
InvalidChannels	Недействительные каналы.
ModelMismatch	Несоответствие модели.
ProjectGenderMismatch	Проект «Гендерное несоответствие».
ModelDeprecated	Модель устарела.
ModelExists	Модель существует.
ModelNotDeployable	Модель не подлежит развертыванию.
EndpointNotUpdatable	Конечная точка не обновляется.
SingleDefaultEndpoint	Единая конечная точка по умолчанию.
EndpointCannotBeDefault	Конечная точка не может быть по умолчанию.
InvalidModelUri	Недопустимый uri модели.
SubscriptionNotFound	Подписка не найдена.
QuotaViolation	Нарушение квот.
UnsupportedDelta	Неподдерживаемая дельта.
UnsupportedFilter	Неподдерживаемый фильтр.
UnsupportedPagination	Неподдерживаемая пагинация.
UnsupportedDynamicConfiguration	Неподдерживаемая динамическая конфигурация.
UnsupportedOrderBy	Неподдерживаемый заказ по.
NoUtf8WithBom	Нет utf8 с bom.
ModelDeploymentNotCompleteState	Развертывание модели не завершено.
SkuLimitsExist	Существуют лимиты Sku.
DeployingFailedModel	Развертывание неудачной модели.
UnsupportedTimeRange	Неподдерживаемый временной диапазон.
InvalidLogDate	Неверная дата входа.
InvalidLogId	Неверный идентификатор журнала.
InvalidLogStartTime	Неверное время начала лога.
InvalidLogEndTime	Неверное время окончания лога.
InvalidTopForLogs	Недопустимая вершина для логов.
InvalidSkipTokenForLogs	Недопустимый маркер пропуска для журналов.
DeleteNotAllowed	Удалять запрещено.
Forbidden	Запретный.
DeployNotAllowed	Развертывание запрещено.
UnexpectedError	Непредвиденная ошибка.
InvalidCollection	Недействительная коллекция.
InvalidCallbackUri	Недопустимый uri обратного вызова.
InvalidSasValidityDuration	Недействительный срок действия sas.
InaccessibleCustomerStorage	Недоступное хранилище для клиентов.
UnsupportedClassBasedAdaptation	Неподдерживаемая адаптация на основе классов.
InvalidWebHookEventKind	Недопустимый тип события веб-перехватчика.
InvalidTimeToLive	Неверное время жизни.
InvalidSourceAzureResourceId	Недопустимый идентификатор исходного ресурса Azure.
ModelCopyAuthorizationExpired	Истек срок действия ModelCopyAuthorization.
EndpointLoggingNotSupported	Ведение журнала конечных точек не поддерживается.
NoLanguageIdentified	Language Identification не распознает ни один язык.
MultipleLanguagesIdentified	Функция идентификации языка распознает несколько языков. Доминирующий язык определить не удалось.
InvalidAudioFormat	Формат входного звука не поддерживается.
BadChannelConfiguration	Существует несоответствие между аудиоканалами в данных, в конфигурации или требованиях приложения.
InvalidChannelSpecification	Выбор каналов в запросе транскрибирования не поддерживается (например, не были выбраны ни 0, ни 1).
AudioLengthLimitExceeded	Продолжительность аудиофайла превышает максимально допустимую продолжительность.
EmptyAudioFile	Аудиофайл пуст.

DiarizationProperties

Object

DiarizationProperties

Имя	Тип	Описание
enabled	boolean	Значение, указывающее, включена ли диаризация динамиков.
maxSpeakers	integer (int32) minimum: 2 maximum: 35	Подсказка по максимальному количеству динамиков для диалогизации. Должно быть больше 1 и меньше 36.

EntityError

Object

EntityError (Ошибка сущности)

Имя	Тип	Описание
code	string	Код данной ошибки.
message	string	Сообщение об этой ошибке.

EntityReference

Object

EntityReference

Имя	Тип	Описание
self	string (uri)	Расположение указанной сущности.

Error

Object

Ошибка

Имя	Тип	Описание
code	ErrorCode	ErrorCode Коды ошибок высокого уровня.
details	Error[]	Дополнительная информация об ошибке и/или ожидаемых политиках.
innerError	InnerError	InnerError Новый формат внутренней ошибки, соответствующий рекомендациям по API Cognitive Services, доступному по адресу https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Он содержит обязательные свойства ErrorCode, message и необязательные свойства target, details (пара ключ-значение), inner error (может быть вложенным).
message	string	Высокоуровневое сообщение об ошибке.
target	string	Источник ошибки. Например, это будет "documents" или "document id" в случае недействительного документа.

ErrorCode

Перечисление

ErrorCode

Значение	Описание
InvalidRequest	Представляет собой код ошибки неверного запроса.
InvalidArgument	Представление кода ошибки недопустимого аргумента.
InternalServerError	Представляет собой внутренний код ошибки сервера.
ServiceUnavailable	Представляющий собой код ошибки недоступности службы.
NotFound	Представляем код ошибки «Не найдено».
PipelineError	Представление кода ошибки конвейера.
Conflict	Представление кода ошибки конфликта.
InternalCommunicationFailed	Представление кода ошибки сбоя внутренней связи.
Forbidden	Представляя собой запрещенный код ошибки.
NotAllowed	Представление неразрешенного кода ошибки.
Unauthorized	Представление несанкционированного кода ошибки.
UnsupportedMediaType	Представляет собой неподдерживаемый код ошибки типа носителя.
TooManyRequests	Представление кода ошибки слишком большого количества запросов.
UnprocessableEntity	Представление кода ошибки необрабатываемой сущности.

InnerError

Object

InnerError

Имя	Тип	Описание
code	DetailedErrorCode	ДетальныйКод ошибки Подробное перечисление кода ошибки.
details	object	Дополнительная информация об ошибке и/или ожидаемых политиках.
innerError	InnerError	InnerError Новый формат внутренней ошибки, соответствующий рекомендациям по API Cognitive Services, доступному по адресу https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Он содержит обязательные свойства ErrorCode, message и необязательные свойства target, details (пара ключ-значение), inner error (может быть вложенным).
message	string	Высокоуровневое сообщение об ошибке.
target	string	Источник ошибки. Например, это будет "documents" или "document id" в случае недействительного документа.

LanguageIdentificationMode

Перечисление

Режим идентификации языка

Значение	Описание
Continuous	Непрерывная идентификация языка (по умолчанию).
Single	Единая идентификация на одном языке. Если язык не может быть идентифицирован, пользователю возвращается код ошибки NoLanguageIdentified . Если между несколькими языками существует неоднозначность, пользователю возвращается код ошибки MultipleLanguagesIdentified .

Значение

Описание

Continuous

Непрерывная идентификация языка (по умолчанию).

Single

Единая идентификация на одном языке. Если язык не может быть идентифицирован, пользователю возвращается код ошибки NoLanguageIdentified . Если между несколькими языками существует неоднозначность, пользователю возвращается код ошибки MultipleLanguagesIdentified .

LanguageIdentificationProperties

Object

LanguageIdentificationProperties

Имя	Тип	Default value	Описание
candidateLocales	string[]		Кандидат языковых стандартов для идентификации языка (например, ["en-US", "de-DE", ", "es-ES"]). В непрерывном режиме поддерживается минимум 2 и максимум 10 потенциальных языковых стандартов, включая основной языковой стандарт для транскрипции. Для идентификации на одном языке максимальное количество потенциальных языковых стандартов не ограничено.
mode	LanguageIdentificationMode	Continuous	Режим идентификации языка Режим, используемый для идентификации языка.
speechModelMapping	<string, EntityReference>		Необязательное сопоставление языковых стандартов с сущностями модели речи. Если модель для языкового стандарта не указана, используется базовая модель по умолчанию. Ключи должны быть локалью, содержащимися в потенциальных локали, значения — сущностями для моделей соответствующих локали.

ProfanityFilterMode

Перечисление

Ненормативная лексикаFilterMode

Значение	Описание
None	Отключите фильтрацию ненормативной лексики.
Removed	Уберите ненормативную лексику.
Tags	Добавление XML-тегов< "ненормативной лексики"/Ненормативная лексика>
Masked	Маскируйте ненормативную лексику с помощью , за исключением первой буквы, например, f**

PunctuationMode

Перечисление

Знак препинанияMode

Значение	Описание
None	Без знаков препинания.
Dictated	Только надиктованные знаки препинания, т.е. явные знаки препинания.
Automatic	Автоматическая пунктуация.
DictatedAndAutomatic	Надиктованные знаки препинания или автоматическая пунктуация.

Status

Перечисление

Состояние

Значение	Описание
NotStarted	Длительная эксплуатация еще не началась.
Running	В настоящее время выполняется длительная операция.
Succeeded	Длительная операция успешно завершена.
Failed	Длительная операция не удалась.

Transcription

Object

Расшифровка

Имя	Тип	Описание
contentContainerUrl	string (uri)	URL-адрес контейнера BLOB-объектов Azure, содержащего аудиофайлы. Контейнер может иметь максимальный размер 5 ГБ и максимальное количество 10000 больших двоичных объектов. Максимальный размер большого двоичного объекта составляет 2,5 ГБ. Контейнер SAS должен содержать разрешения 'r' (чтение) и 'l' (список). Это свойство не будет возвращено в ответе.
contentUrls	string[] (uri)	Список URL-адресов содержимого для расшифровки аудиофайлов. Допускается до 1000 URL. Это свойство не будет возвращено в ответе.
createdDateTime	string (date-time)	Временная метка создания объекта. Временная метка кодируется в формате даты и времени 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 minLength: 1	Отображаемое имя объекта.
lastActionDateTime	string (date-time)	Метка времени ввода текущего статуса. Временная метка кодируется в формате даты и времени ISO 8601 («YYYY-MM-DDThh:mm:ssZ», см. https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	TranscriptionLinks	ТранскрипцияСсылки
locale	string minLength: 1	Языковой стандарт содержащихся данных. Если используется идентификация языка, этот языковой стандарт используется для транскрибирования речи, для которой не удалось обнаружить язык.
model	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	TranscriptionProperties	ТранскрибированиеProperties
self	string (uri)	Местонахождение этого объекта.
status	Status	Состояние Опишите текущее состояние API.

TranscriptionLinks

Object

ТранскрипцияСсылки

Имя	Тип	Описание
files	string (uri)	Расположение для получения всех файлов этой сущности. Подробнее см. в операции "Transcriptions_ListFiles".

TranscriptionProperties

Object

ТранскрибированиеProperties

Имя	Тип	Default value	Описание
channels	integer[] (int32)		Набор запрошенных номеров каналов. В случае по умолчанию учитываются каналы 0 и 1.
destinationContainerUrl	string (uri)		Запрошенный контейнер назначения. Замечания Если целевой контейнер используется в сочетании с `timeToLive`, метаданные транскрибирования будут удалены обычным образом, но данные, хранящиеся в целевом контейнере, включая результаты транскрибирования, останутся нетронутыми, так как для этого контейнера не требуются разрешения на удаление. Чтобы обеспечить поддержку автоматической очистки, настройте время существования BLOB-объектов в контейнере или используйте параметр "Использование собственного хранилища (BYOS)" вместо `destinationContainerUrl`, где можно очистить BLOB-объекты.
diarization	DiarizationProperties		DiarizationProperties
displayFormWordLevelTimestampsEnabled	boolean		Значение, указывающее, запрашиваются ли метки времени уровня слова для формы отображения. Значение по умолчанию — `false`.
durationMilliseconds	integer (int64)	0	Длительность транскрипции в миллисекундах. Длительности больше 2^53-1 не поддерживаются для обеспечения совместимости с целыми числами JavaScript.
error	EntityError		EntityError (Ошибка сущности)
languageIdentification	LanguageIdentificationProperties		LanguageIdentificationProperties
profanityFilterMode	ProfanityFilterMode		Ненормативная лексикаFilterMode Режим фильтрации ненормативной лексики.
punctuationMode	PunctuationMode		Знак препинанияMode Режим, используемый для препинания.
timeToLiveHours	integer (int32)		Как долго транскрибирование будет храниться в системе после завершения. Как только транскрипция достигнет срока жизни после завершения (успешного или неудачного), она будет автоматически удалена. Примечание: При использовании BYOS (использование собственного хранилища) файлы результатов в учетной записи хранения, принадлежащей клиенту, также будут удалены. Используйте destinationContainerUrl, чтобы указать отдельный контейнер для файлов результатов, которые не будут удалены по истечении timeToLive, или извлеките файлы результатов через API и сохраните их по мере необходимости. Кратчайшая поддерживаемая длительность составляет 6 часов, самая длинная поддерживаемая длительность — 31 дней. 2 дня (48 часов) — рекомендуемое значение по умолчанию при непосредственном использовании данных.
wordLevelTimestampsEnabled	boolean		Значение, указывающее, запрашиваются ли метки времени уровня слова. Значение по умолчанию — `false`.

Transcriptions - Submit

Параметры URI

Заголовок запроса

Текст запроса

Ответы

Безопасность

Ocp-Apim-Subscription-Key

Примеры

Create a transcription for URIs

Образец запроса

Пример ответа

Create a transcription from blob container

Образец запроса

Пример ответа

Create a transcription with language identification

Образец запроса

Пример ответа

Create a transcription with multispeaker diarization

Образец запроса

Пример ответа

Определения

DetailedErrorCode

DiarizationProperties

EntityError

EntityReference

Error

ErrorCode

InnerError

LanguageIdentificationMode

LanguageIdentificationProperties

ProfanityFilterMode

PunctuationMode

Status

Transcription

TranscriptionLinks

TranscriptionProperties

Замечания