Transcriptions - Submit

Serviço:: Azure AI Services

Versão da API:: 2025-10-15

Envia um novo trabalho de transcrição.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
endpoint	path	True	string	Pontos de extremidade dos Serviços Cognitivos com suporte (protocolo e nome do host, por exemplo: https://westus.api.cognitive.microsoft.com).
api-version	query	True	string	A versão da API solicitada.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
Ocp-Apim-Subscription-Key	True	string	Forneça sua chave de conta de serviços cognitivos aqui.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
displayName	True	string minLength: 1	O nome de exibição do objeto.
locale	True	string minLength: 1	A localidade dos dados contidos. Se a Identificação de Idiomas for usada, essa localidade será usada para transcrever a fala para a qual nenhum idioma pode ser detectado.
properties	True	TranscriptionProperties	TranscriptionProperties
contentContainerUrl		string (uri)	Uma URL para um contêiner de blob do Azure que contém os arquivos de áudio. Um contêiner pode ter um tamanho máximo de 5 GB e um número máximo de 10000 blobs. O tamanho máximo de um blob é de 2,5 GB. A SAS do contêiner deve conter permissões 'r' (leitura) e 'l' (lista). Essa propriedade não será retornada em uma resposta.
contentUrls		string[] (uri)	Uma lista de URLs de conteúdo para obter arquivos de áudio para transcrever. São permitidos até 1000 urls. Essa propriedade não será retornada em uma resposta.
customProperties		object	As propriedades personalizadas dessa entidade. O comprimento máximo permitido da chave é de 64 caracteres, o comprimento máximo permitido do valor é de 256 caracteres e a contagem de entradas permitidas é 10.
dataset		EntityReference	EntityReference
description		string	A descrição do objeto.
model		EntityReference	EntityReference
project		EntityReference	EntityReference

Respostas

Nome	Tipo	Description
201 Created	Transcription	A resposta contém informações sobre a entidade como carga e sua localização como cabeçalho. Cabeçalhos Location: string
Other Status Codes	Error	Ocorreu um erro.

Nome

Tipo

Description

201 Created

Transcription

A resposta contém informações sobre a entidade como carga e sua localização como cabeçalho.

Cabeçalhos

Location: string

Other Status Codes

Error

Ocorreu um erro.

Segurança

Ocp-Apim-Subscription-Key

Forneça sua chave de conta de serviços cognitivos aqui.

Tipo: apiKey
Em: header

Exemplos

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

Solicitação de exemplo

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
  }
}

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

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/"
}

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

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"
    }
  }
}

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

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
    }
  }
}

Resposta de exemplo

Código de status:: 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"
}

Definições

Nome	Description
DetailedErrorCode	Código de erro detalhado
DiarizationProperties	DiarizationProperties
EntityError	Erro de entidade
EntityReference	EntityReference
Error	Erro
ErrorCode	ErrorCode
InnerError	InnerError
LanguageIdentificationMode	Modo de identificação de idioma
LanguageIdentificationProperties	LanguageIdentificationProperties
ProfanityFilterMode	ProfanityFilterMode
PunctuationMode	PontuaçãoMode
Status	Situação
Transcription	Transcrição
TranscriptionLinks	Links de transcrição
TranscriptionProperties	TranscriptionProperties

DetailedErrorCode

Enumeração

Código de erro detalhado

Valor	Description
InvalidParameterValue	Valor de parâmetro inválido.
InvalidRequestBodyFormat	Formato de corpo de solicitação inválido.
EmptyRequest	Solicitação vazia.
MissingInputRecords	Registros de entrada ausentes.
InvalidDocument	Documento inválido.
ModelVersionIncorrect	Versão do modelo incorreta.
InvalidDocumentBatch	Lote de documentos inválido.
UnsupportedLanguageCode	Código de idioma sem suporte.
DataImportFailed	Falha na importação de dados.
InUseViolation	Violação em uso.
InvalidLocale	Localidade inválida.
InvalidBaseModel	Modelo base inválido.
InvalidAdaptationMapping	Mapeamento de adaptação inválido.
InvalidDataset	Conjunto de dados inválido.
InvalidTest	Teste inválido.
FailedDataset	Conjunto de dados com falha.
InvalidModel	Modelo inválido.
InvalidTranscription	Transcrição inválida.
InvalidPayload	Carga inválida.
InvalidParameter	Parâmetro inválido.
EndpointWithoutLogging	Ponto de extremidade sem registro.
InvalidPermissions	Permissões inválidas.
InvalidPrerequisite	Pré-requisito inválido.
InvalidProductId	ID do produto inválido.
InvalidSubscription	Assinatura inválida.
InvalidProject	Projeto inválido.
InvalidProjectKind	Tipo de projeto inválido.
InvalidRecordingsUri	Uri de gravações inválidas.
OnlyOneOfUrlsOrContainerOrDataset	Apenas um dos urls ou contêiner ou conjunto de dados.
ExceededNumberOfRecordingsUris	Número excedido de uris de gravações.
InvalidChannels	Canais inválidos.
ModelMismatch	Incompatibilidade de modelo.
ProjectGenderMismatch	Incompatibilidade de gênero do projeto.
ModelDeprecated	Modelo preterido.
ModelExists	O modelo existe.
ModelNotDeployable	Modelo não implantável.
EndpointNotUpdatable	Ponto de extremidade não atualizável.
SingleDefaultEndpoint	Ponto de extremidade padrão único.
EndpointCannotBeDefault	O ponto de extremidade não pode ser padrão.
InvalidModelUri	Uri de modelo inválido.
SubscriptionNotFound	Assinatura não encontrada.
QuotaViolation	Violação de cotas.
UnsupportedDelta	Delta sem suporte.
UnsupportedFilter	Filtro não suportado.
UnsupportedPagination	Paginação sem suporte.
UnsupportedDynamicConfiguration	Configuração dinâmica não suportada.
UnsupportedOrderBy	Ordem não suportada por.
NoUtf8WithBom	Sem utf8 com bom.
ModelDeploymentNotCompleteState	A implantação do modelo não está concluída.
SkuLimitsExist	Existem limites de SKU.
DeployingFailedModel	Implantando o modelo com falha.
UnsupportedTimeRange	Intervalo de tempo sem suporte.
InvalidLogDate	Data de log inválida.
InvalidLogId	ID de log inválido.
InvalidLogStartTime	Hora de início do log inválida.
InvalidLogEndTime	Hora de término do log inválida.
InvalidTopForLogs	Parte superior inválida para logs.
InvalidSkipTokenForLogs	Token de ignorar inválido para logs.
DeleteNotAllowed	Excluir não permitido.
Forbidden	Negado.
DeployNotAllowed	Implantação não permitida.
UnexpectedError	Erro inesperado.
InvalidCollection	Cobrança inválida.
InvalidCallbackUri	Uri de retorno de chamada inválido.
InvalidSasValidityDuration	Duração de validade do SAS inválida.
InaccessibleCustomerStorage	Armazenamento inacessível do cliente.
UnsupportedClassBasedAdaptation	Adaptação baseada em classe sem suporte.
InvalidWebHookEventKind	Tipo de evento de web hook inválido.
InvalidTimeToLive	Tempo de vida inválido.
InvalidSourceAzureResourceId	ID de recurso do Azure de origem inválida.
ModelCopyAuthorizationExpired	ModelCopyAuthorization expirado.
EndpointLoggingNotSupported	Não há suporte para o registro de endpoint.
NoLanguageIdentified	A Identificação de Idioma não reconheceu nenhum idioma.
MultipleLanguagesIdentified	A identificação de idiomas reconheceu vários idiomas. Nenhuma língua dominante pôde ser determinada.
InvalidAudioFormat	O formato de áudio de entrada não é suportado.
BadChannelConfiguration	Há uma incompatibilidade entre os canais de áudio nos dados, na configuração ou nos requisitos do aplicativo.
InvalidChannelSpecification	A seleção de canais na solicitação de transcrição não é suportada (por exemplo, nem 0 nem 1 foram selecionados).
AudioLengthLimitExceeded	O arquivo de áudio é maior do que a duração máxima permitida.
EmptyAudioFile	O arquivo de áudio está vazio.

DiarizationProperties

Objeto

DiarizationProperties

Nome	Tipo	Description
enabled	boolean	Um valor que indica se a diarização do alto-falante está habilitada.
maxSpeakers	integer (int32) minimum: 2 maximum: 35	Uma dica para o número máximo de alto-falantes para diarização. Deve ser maior que 1 e menor que 36.

EntityError

Objeto

Erro de entidade

Nome	Tipo	Description
code	string	O código desse erro.
message	string	A mensagem para esse erro.

EntityReference

Objeto

EntityReference

Nome	Tipo	Description
self	string (uri)	O local da entidade referenciada.

Error

Objeto

Erro

Nome	Tipo	Description
code	ErrorCode	ErrorCode Códigos de erro de alto nível.
details	Error[]	Detalhes adicionais de suporte sobre o erro e/ou políticas esperadas.
innerError	InnerError	InnerError Novo formato de Erro Interno que está em conformidade com as Diretrizes da API dos Serviços Cognitivos, disponível em https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Isso contém as propriedades necessárias ErrorCode, mensagem e propriedades opcionais target, details(par de valores-chave), erro interno(isso pode ser aninhado).
message	string	Mensagem de erro de alto nível.
target	string	A origem do erro. Por exemplo, seria "documentos" ou "ID do documento" no caso de documento inválido.

ErrorCode

Enumeração

ErrorCode

Valor	Description
InvalidRequest	Representando o código de erro de solicitação inválido.
InvalidArgument	Representando o código de erro de argumento inválido.
InternalServerError	Representando o código de erro de erro interno do servidor.
ServiceUnavailable	Representando o código de erro de serviço indisponível.
NotFound	Representando o código de erro não encontrado.
PipelineError	Representando o código de erro de erro do pipeline.
Conflict	Representando o código de erro de conflito.
InternalCommunicationFailed	Representando o código de erro de falha de comunicação interna.
Forbidden	Representando o código de erro proibido.
NotAllowed	Representando o código de erro não permitido.
Unauthorized	Representando o código de erro não autorizado.
UnsupportedMediaType	Representando o código de erro de tipo de mídia sem suporte.
TooManyRequests	Representando o código de erro de muitas solicitações.
UnprocessableEntity	Representando o código de erro da entidade não processável.

InnerError

Objeto

InnerError

Nome	Tipo	Description
code	DetailedErrorCode	Código de erro detalhado Enumeração detalhada do código de erro.
details	object	Detalhes adicionais de suporte sobre o erro e/ou políticas esperadas.
innerError	InnerError	InnerError Novo formato de Erro Interno que está em conformidade com as Diretrizes da API dos Serviços Cognitivos, disponível em https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Isso contém as propriedades necessárias ErrorCode, mensagem e propriedades opcionais target, details(par de valores-chave), erro interno(isso pode ser aninhado).
message	string	Mensagem de erro de alto nível.
target	string	A origem do erro. Por exemplo, seria "documentos" ou "ID do documento" no caso de documento inválido.

LanguageIdentificationMode

Enumeração

Modo de identificação de idioma

Valor	Description
Continuous	Identificação contínua de idioma (padrão).
Single	Identificação de idioma único. Se nenhum idioma puder ser identificado, o código de erro NoLanguageIdentified será retornado ao usuário. Se houver ambiguidade entre vários idiomas, o código de erro MultipleLanguagesIdentified será retornado ao usuário.

LanguageIdentificationProperties

Objeto

LanguageIdentificationProperties

Nome	Tipo	Valor padrão	Description
candidateLocales	string[]		As localidades candidatas para identificação de idioma (exemplo ["en-US", "de-DE", "es-ES"]). Um mínimo de 2 e um máximo de 10 localidades candidatas, incluindo a localidade principal para a transcrição, são suportadas para o modo contínuo. Para identificação de idioma único, o número máximo de localidades candidatas é ilimitado.
mode	LanguageIdentificationMode	Continuous	Modo de identificação de idioma O modo usado para identificação de idioma.
speechModelMapping	<string, EntityReference>		Um mapeamento opcional de localidades para entidades de modelo de fala. Se nenhum modelo for fornecido para uma localidade, o modelo base padrão será usado. As chaves devem ser localidades contidas nas localidades candidatas, os valores são entidades para modelos das respectivas localidades.

ProfanityFilterMode

Enumeração

ProfanityFilterMode

Valor	Description
None	Desative a filtragem de palavrões.
Removed	Remova palavrões.
Tags	Adicionar tags XML de "palavrões<"/palavrões>
Masked	Mascare os palavrões com , exceto da primeira letra, por exemplo, f **

PunctuationMode

Enumeração

PontuaçãoMode

Valor	Description
None	Sem pontuação.
Dictated	Apenas sinais de pontuação ditados, ou seja, pontuação explícita.
Automatic	Pontuação automática.
DictatedAndAutomatic	Sinais de pontuação ditados ou pontuação automática.

Status

Enumeração

Situação

Valor	Description
NotStarted	A operação de longa duração ainda não começou.
Running	A operação de execução longa está sendo processada no momento.
Succeeded	A operação de execução longa foi concluída com êxito.
Failed	A operação de execução longa falhou.

Transcription

Objeto

Transcrição

Nome	Tipo	Description
contentContainerUrl	string (uri)	Uma URL para um contêiner de blob do Azure que contém os arquivos de áudio. Um contêiner pode ter um tamanho máximo de 5 GB e um número máximo de 10000 blobs. O tamanho máximo de um blob é de 2,5 GB. A SAS do contêiner deve conter permissões 'r' (leitura) e 'l' (lista). Essa propriedade não será retornada em uma resposta.
contentUrls	string[] (uri)	Uma lista de URLs de conteúdo para obter arquivos de áudio para transcrever. São permitidos até 1000 urls. Essa propriedade não será retornada em uma resposta.
createdDateTime	string (date-time)	O carimbo de data/hora em que o objeto foi criado. O carimbo de data/hora é codificado como formato de data e hora ISO 8601 ("AAAA-MM-DDThh:mm:ssZ", consulte https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties	object	As propriedades personalizadas dessa entidade. O comprimento máximo permitido da chave é de 64 caracteres, o comprimento máximo permitido do valor é de 256 caracteres e a contagem de entradas permitidas é 10.
dataset	EntityReference	EntityReference
description	string	A descrição do objeto.
displayName	string minLength: 1	O nome de exibição do objeto.
lastActionDateTime	string (date-time)	O carimbo de data/hora em que o status atual foi inserido. O carimbo de data/hora é codificado como formato de data e hora ISO 8601 ("AAAA-MM-DDThh:mm:ssZ", consulte https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	TranscriptionLinks	Links de transcrição
locale	string minLength: 1	A localidade dos dados contidos. Se a Identificação de Idiomas for usada, essa localidade será usada para transcrever a fala para a qual nenhum idioma pode ser detectado.
model	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	TranscriptionProperties	TranscriptionProperties
self	string (uri)	A localização desta entidade.
status	Status	Situação Descreva o estado atual da API.

TranscriptionLinks

Objeto

Links de transcrição

Nome	Tipo	Description
files	string (uri)	O local para obter todos os arquivos dessa entidade. Consulte a operação "Transcriptions_ListFiles" para obter mais detalhes.

TranscriptionProperties

Objeto

TranscriptionProperties

Nome	Tipo	Valor padrão	Description
channels	integer[] (int32)		Uma coleção dos números de canal solicitados. No caso padrão, os canais 0 e 1 são considerados.
destinationContainerUrl	string (uri)		O contêiner de destino solicitado. Observações Quando um contêiner de destino é usado em combinação com um `timeToLive`, os metadados de uma transcrição serão excluídos normalmente, mas os dados armazenados no contêiner de destino, incluindo os resultados da transcrição, permanecerão intocados, pois nenhuma permissão de exclusão é necessária para esse contêiner. Para dar suporte à limpeza automática, configure tempos de vida de blob no contêiner ou use "Traga seu próprio armazenamento (BYOS)" em vez de `destinationContainerUrl`, onde os blobs podem ser limpos.
diarization	DiarizationProperties		DiarizationProperties
displayFormWordLevelTimestampsEnabled	boolean		Um valor que indica se os carimbos de data/hora de nível de palavra para o formulário de exibição são solicitados. O valor padrão é `false`.
durationMilliseconds	integer (int64)	0	A duração em milissegundos da transcrição. Durações maiores que 2^53-1 não são suportadas para garantir a compatibilidade com inteiros JavaScript.
error	EntityError		Erro de entidade
languageIdentification	LanguageIdentificationProperties		LanguageIdentificationProperties
profanityFilterMode	ProfanityFilterMode		ProfanityFilterMode Modo de filtragem de palavrões.
punctuationMode	PunctuationMode		PontuaçãoMode O modo usado para pontuação.
timeToLiveHours	integer (int32)		Por quanto tempo a transcrição será mantida no sistema após a conclusão. Assim que a transcrição atingir o tempo de vida após a conclusão (bem-sucedida ou falha), ela será excluída automaticamente. Observação: ao usar o BYOS (traga seu próprio armazenamento), os arquivos de resultados na conta de armazenamento de propriedade do cliente também serão excluídos. Use destinationContainerUrl para especificar um contêiner separado para arquivos de resultado que não serão excluídos quando o timeToLive expirar ou recupere os arquivos de resultado por meio da API e armazene-os conforme necessário. A duração mais curta com suporte é de 6 horas, a duração mais longa com suporte é de 31 dias. 2 dias (48 horas) é o valor padrão recomendado quando os dados são consumidos diretamente.
wordLevelTimestampsEnabled	boolean		Um valor que indica se os carimbos de data/hora de nível de palavra são solicitados. O valor padrão é `false`.

Compartilhar via

Transcriptions - Submit

Parâmetros de URI

Cabeçalho da solicitação

Corpo da solicitação

Respostas

Segurança

Ocp-Apim-Subscription-Key

Exemplos

Create a transcription for URIs

Solicitação de exemplo

Resposta de exemplo

Create a transcription from blob container

Solicitação de exemplo

Resposta de exemplo

Create a transcription with language identification

Solicitação de exemplo

Resposta de exemplo

Create a transcription with multispeaker diarization

Solicitação de exemplo

Resposta de exemplo

Definições

DetailedErrorCode

DiarizationProperties

EntityError

EntityReference

Error

ErrorCode

InnerError

LanguageIdentificationMode

LanguageIdentificationProperties

ProfanityFilterMode

PunctuationMode

Status

Transcription

TranscriptionLinks

TranscriptionProperties

Observações