Transcriptions - Submit

Servicio:: Azure AI Services

Versión de la API:: 2025-10-15

Envía un nuevo trabajo de transcripción.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://westus.api.cognitive.microsoft.com).
api-version	query	True	string	La versión de la API solicitada.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Ocp-Apim-Subscription-Key	True	string	Proporcione la clave de cuenta de Cognitive Services aquí.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
displayName	True	string minLength: 1	Nombre para mostrar del objeto.
locale	True	string minLength: 1	Configuración regional de los datos contenidos. Si se usa la identificación de idioma, esta configuración regional se usa para transcribir la voz para la que no se pudo detectar ningún idioma.
properties	True	TranscriptionProperties	TranscriptionProperties
contentContainerUrl		string (uri)	Dirección URL de un contenedor de blobs de Azure que contiene los archivos de audio. Un contenedor puede tener un tamaño máximo de 5 GB y un número máximo de 10000 blobs. El tamaño máximo de un blob es de 2,5 GB. La SAS de contenedor debe contener permisos "r" (lectura) y "l" (lista). Esta propiedad no se devolverá en una respuesta.
contentUrls		string[] (uri)	Una lista de URL de contenido para transcribir archivos de audio. Se permiten hasta 1000 urls. Esta propiedad no se devolverá en una respuesta.
customProperties		object	Propiedades personalizadas de esta entidad. La longitud máxima permitida de la clave es de 64 caracteres, la longitud máxima permitida del valor es de 256 caracteres y el recuento de entradas permitidas es de 10.
dataset		EntityReference	EntityReference
description		string	Descripción del objeto.
model		EntityReference	EntityReference
project		EntityReference	EntityReference

Respuestas

Nombre	Tipo	Description
201 Created	Transcription	La respuesta contiene información sobre la entidad como carga útil y su ubicación como encabezado. Encabezados Location: string
Other Status Codes	Error	Se produjo un error.

Nombre

Tipo

Description

201 Created

Transcription

La respuesta contiene información sobre la entidad como carga útil y su ubicación como encabezado.

Encabezados

Location: string

Other Status Codes

Error

Se produjo un error.

Seguridad

Ocp-Apim-Subscription-Key

Proporcione la clave de cuenta de Cognitive Services aquí.

Tipo: apiKey
En: header

Ejemplos

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

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 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

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 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

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 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

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 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"
}

Definiciones

Nombre	Description
DetailedErrorCode	Código de error detallado
DiarizationProperties	DiarizationProperties
EntityError	EntityError
EntityReference	EntityReference
Error	Error
ErrorCode	ErrorCode
InnerError	InnerError
LanguageIdentificationMode	LanguageIdentificationMode
LanguageIdentificationProperties	LanguageIdentificationProperties
ProfanityFilterMode	ProfanityFilterMode
PunctuationMode	PuntuaciónMode
Status	Estado
Transcription	Transcripción
TranscriptionLinks	TranscripciónEnlaces
TranscriptionProperties	TranscriptionProperties

DetailedErrorCode

Enumeración

Código de error detallado

Valor	Description
InvalidParameterValue	Valor de parámetro no válido.
InvalidRequestBodyFormat	Formato de cuerpo de solicitud no válido.
EmptyRequest	Solicitud vacía.
MissingInputRecords	Faltan registros de entrada.
InvalidDocument	Documento no válido.
ModelVersionIncorrect	Versión del modelo incorrecta.
InvalidDocumentBatch	Lote de documentos no válido.
UnsupportedLanguageCode	Código de idioma no admitido.
DataImportFailed	Error en la importación de datos.
InUseViolation	Violación en uso.
InvalidLocale	Configuración regional no válida.
InvalidBaseModel	Modelo base no válido.
InvalidAdaptationMapping	Asignación de adaptación no válida.
InvalidDataset	Conjunto de datos no válido.
InvalidTest	Prueba no válida.
FailedDataset	Conjunto de datos fallido.
InvalidModel	Modelo no válido.
InvalidTranscription	Transcripción no válida.
InvalidPayload	Carga útil no válida.
InvalidParameter	El parámetro no es válido.
EndpointWithoutLogging	Punto final sin registro.
InvalidPermissions	Permisos no válidos.
InvalidPrerequisite	Requisito previo no válido.
InvalidProductId	ID de producto no válido.
InvalidSubscription	Suscripción no válida.
InvalidProject	Proyecto no válido.
InvalidProjectKind	Tipo de proyecto no válido.
InvalidRecordingsUri	Uri de grabaciones no válidas.
OnlyOneOfUrlsOrContainerOrDataset	Solo una de las direcciones URL o contenedor o conjunto de datos.
ExceededNumberOfRecordingsUris	Se ha superado el número de registros uris.
InvalidChannels	Canales no válidos.
ModelMismatch	Desajuste del modelo.
ProjectGenderMismatch	Proyectar desajuste de género.
ModelDeprecated	Modelo obsoleto.
ModelExists	El modelo existe.
ModelNotDeployable	Modelo no desplegable.
EndpointNotUpdatable	Punto de conexión no actualizable.
SingleDefaultEndpoint	Único punto de conexión predeterminado.
EndpointCannotBeDefault	El punto de conexión no puede ser predeterminado.
InvalidModelUri	URI de modelo no válido.
SubscriptionNotFound	Suscripción no encontrada.
QuotaViolation	Violación de cuota.
UnsupportedDelta	Delta no admitido.
UnsupportedFilter	Filtro no compatible.
UnsupportedPagination	Paginación no admitida.
UnsupportedDynamicConfiguration	Configuración dinámica no admitida.
UnsupportedOrderBy	Pedido no admitido por.
NoUtf8WithBom	No utf8 con bom.
ModelDeploymentNotCompleteState	Estado de implementación del modelo no completo.
SkuLimitsExist	Existen límites de SKU.
DeployingFailedModel	Implementación del modelo fallido.
UnsupportedTimeRange	Intervalo de tiempo no admitido.
InvalidLogDate	Fecha de registro no válida.
InvalidLogId	ID de registro no válido.
InvalidLogStartTime	Hora de inicio del registro no válida.
InvalidLogEndTime	Hora de finalización del registro no válida.
InvalidTopForLogs	Tapa no válida para troncos.
InvalidSkipTokenForLogs	Token de omisión no válido para los registros.
DeleteNotAllowed	No se permite eliminar.
Forbidden	Prohibido.
DeployNotAllowed	Implementación no permitida.
UnexpectedError	Error inesperado.
InvalidCollection	Colección no válida.
InvalidCallbackUri	URI de devolución de llamada no válido.
InvalidSasValidityDuration	Duración de validez de SAS no válida.
InaccessibleCustomerStorage	Almacenamiento inaccesible del cliente.
UnsupportedClassBasedAdaptation	Adaptación basada en clases sin apoyo.
InvalidWebHookEventKind	Tipo de evento de enlace web no válido.
InvalidTimeToLive	Tiempo de vida no válido.
InvalidSourceAzureResourceId	Identificador de recurso de Azure de origen no válido.
ModelCopyAuthorizationExpired	ModelCopyAuthorization expirado.
EndpointLoggingNotSupported	No se admite el registro de puntos de conexión.
NoLanguageIdentified	Language Identification no reconoció ningún idioma.
MultipleLanguagesIdentified	La identificación de idiomas reconoció varios idiomas. No se pudo determinar ningún idioma dominante.
InvalidAudioFormat	No se admite el formato de audio de entrada.
BadChannelConfiguration	Hay una discrepancia entre los canales de audio en los datos, en la configuración o los requisitos de la aplicación.
InvalidChannelSpecification	No se admite la selección de canales en la solicitud de transcripción (por ejemplo, no se han seleccionado ni 0 ni 1).
AudioLengthLimitExceeded	El archivo de audio es más largo que la duración máxima permitida.
EmptyAudioFile	El archivo de audio está vacío.

DiarizationProperties

Object

DiarizationProperties

Nombre	Tipo	Description
enabled	boolean	Valor que indica si la diarización de hablantes está habilitada.
maxSpeakers	integer (int32) minimum: 2 maximum: 35	Una sugerencia para el número máximo de hablantes para la diarización. Debe ser mayor que 1 y menor que 36.

EntityError

Object

EntityError

Nombre	Tipo	Description
code	string	El código de este error.
message	string	El mensaje de este error.

EntityReference

Object

EntityReference

Nombre	Tipo	Description
self	string (uri)	Ubicación de la entidad a la que se hace referencia.

Error

Object

Error

Nombre	Tipo	Description
code	ErrorCode	ErrorCode Códigos de error de alto nivel.
details	Error[]	Detalles de apoyo adicionales sobre el error y/o las políticas esperadas.
innerError	InnerError	InnerError Nuevo formato de error interno que se ajusta a las directrices de la API de Cognitive Services que está disponible en https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene las propiedades necesarias ErrorCode, mensaje y propiedades opcionales target, details (par clave-valor), inner error (esto se puede anidar).
message	string	Mensaje de error de alto nivel.
target	string	Origen del error. Por ejemplo, sería "documentos" o "id de documento" en caso de documento no válido.

ErrorCode

Enumeración

ErrorCode

Valor	Description
InvalidRequest	Representación del código de error de solicitud no válido.
InvalidArgument	Representación del código de error del argumento no válido.
InternalServerError	Representación del código de error interno del servidor.
ServiceUnavailable	Representación del código de error de servicio no disponible.
NotFound	Representación del código de error no encontrado.
PipelineError	Representación del código de error de canalización.
Conflict	Representación del código de error de conflicto.
InternalCommunicationFailed	Representación del código de error de comunicación interna.
Forbidden	Representación del código de error prohibido.
NotAllowed	Representación del código de error no permitido.
Unauthorized	Representación del código de error no autorizado.
UnsupportedMediaType	Representación del código de error de tipo de medio no admitido.
TooManyRequests	Representación del código de error de demasiadas solicitudes.
UnprocessableEntity	Representación del código de error de entidad no procesable.

InnerError

Object

InnerError

Nombre	Tipo	Description
code	DetailedErrorCode	Código de error detallado Enumeración detallada del código de error.
details	object	Detalles de apoyo adicionales sobre el error y/o las políticas esperadas.
innerError	InnerError	InnerError Nuevo formato de error interno que se ajusta a las directrices de la API de Cognitive Services que está disponible en https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene las propiedades necesarias ErrorCode, mensaje y propiedades opcionales target, details (par clave-valor), inner error (esto se puede anidar).
message	string	Mensaje de error de alto nivel.
target	string	Origen del error. Por ejemplo, sería "documentos" o "id de documento" en caso de documento no válido.

LanguageIdentificationMode

Enumeración

LanguageIdentificationMode

Valor	Description
Continuous	Identificación continua del idioma (predeterminado).
Single	Identificación en un solo idioma. Si no se puede identificar ningún idioma, se devuelve al usuario el código de error NoLanguageIdentified . Si hay ambigüedad entre varios idiomas, se devuelve al usuario el código de error MultipleLanguagesIdentified .

LanguageIdentificationProperties

Object

LanguageIdentificationProperties

Nombre	Tipo	Valor predeterminado	Description
candidateLocales	string[]		Las configuraciones regionales candidatas para la identificación del idioma (ejemplo ["en-US", "de-DE", "es-ES"]). Se admite un mínimo de 2 y un máximo de 10 configuraciones regionales candidatas, incluida la configuración regional principal para la transcripción, para el modo continuo. Para la identificación de un solo idioma, el número máximo de configuraciones regionales candidatas no está enlazado.
mode	LanguageIdentificationMode	Continuous	LanguageIdentificationMode El modo utilizado para la identificación del idioma.
speechModelMapping	<string, EntityReference>		Asignación opcional de configuraciones regionales a entidades del modelo de voz. Si no se proporciona ningún modelo para una configuración regional, se usa el modelo base predeterminado. Las claves deben ser configuraciones regionales contenidas en las configuraciones regionales candidatas, los valores son entidades para los modelos de las respectivas configuraciones regionales.

ProfanityFilterMode

Enumeración

ProfanityFilterMode

Valor	Description
None	Deshabilite el filtrado de blasfemias.
Removed	Elimine las blasfemias.
Tags	Agregar etiquetas< XML de "blasfemias" / Blasfemias>
Masked	Enmascare la blasfemia con * excepto de la primera letra, por ejemplo, f ***

PunctuationMode

Enumeración

PuntuaciónMode

Valor	Description
None	Sin puntuación.
Dictated	Solo signos de puntuación dictados, es decir, puntuación explícita.
Automatic	Puntuación automática.
DictatedAndAutomatic	Signos de puntuación dictados o puntuación automática.

Status

Enumeración

Estado

Valor	Description
NotStarted	La operación de larga duración aún no ha comenzado.
Running	La operación de larga duración se está procesando actualmente.
Succeeded	La operación de larga duración se ha completado correctamente.
Failed	Se ha producido un error en la operación de larga duración.

Transcription

Object

Transcripción

Nombre	Tipo	Description
contentContainerUrl	string (uri)	Dirección URL de un contenedor de blobs de Azure que contiene los archivos de audio. Un contenedor puede tener un tamaño máximo de 5 GB y un número máximo de 10000 blobs. El tamaño máximo de un blob es de 2,5 GB. La SAS de contenedor debe contener permisos "r" (lectura) y "l" (lista). Esta propiedad no se devolverá en una respuesta.
contentUrls	string[] (uri)	Una lista de URL de contenido para transcribir archivos de audio. Se permiten hasta 1000 urls. Esta propiedad no se devolverá en una respuesta.
createdDateTime	string (date-time)	La marca de tiempo en la que se creó el objeto. La marca de tiempo se codifica como formato de fecha y hora ISO 8601 ("AAAA-MM-DDThh:mm:ssZ", consulte https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties	object	Propiedades personalizadas de esta entidad. La longitud máxima permitida de la clave es de 64 caracteres, la longitud máxima permitida del valor es de 256 caracteres y el recuento de entradas permitidas es de 10.
dataset	EntityReference	EntityReference
description	string	Descripción del objeto.
displayName	string minLength: 1	Nombre para mostrar del objeto.
lastActionDateTime	string (date-time)	La marca de tiempo en la que se introdujo el estado actual. La marca de tiempo se codifica como formato de fecha y hora ISO 8601 ("AAAA-MM-DDThh:mm:ssZ", consulte https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	TranscriptionLinks	TranscripciónEnlaces
locale	string minLength: 1	Configuración regional de los datos contenidos. Si se usa la identificación de idioma, esta configuración regional se usa para transcribir la voz para la que no se pudo detectar ningún idioma.
model	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	TranscriptionProperties	TranscriptionProperties
self	string (uri)	La ubicación de esta entidad.
status	Status	Estado Describa el estado actual de la API.

TranscriptionLinks

Object

TranscripciónEnlaces

Nombre	Tipo	Description
files	string (uri)	La ubicación para obtener todos los archivos de esta entidad. Consulte la operación "Transcriptions_ListFiles" para obtener más detalles.

TranscriptionProperties

Object

TranscriptionProperties

Nombre	Tipo	Valor predeterminado	Description
channels	integer[] (int32)		Una colección de los números de canal solicitados. En el caso predeterminado, se consideran los canales 0 y 1.
destinationContainerUrl	string (uri)		El contenedor de destino solicitado. Observaciones Cuando se usa un contenedor de destino en combinación con un `timeToLive`, los metadatos de una transcripción se eliminarán normalmente, pero los datos almacenados en el contenedor de destino, incluidos los resultados de la transcripción, permanecerán intactos, ya que no se requieren permisos de eliminación para este contenedor. Para admitir la limpieza automática, configure la duración de los blobs en el contenedor o use "Bring your own Storage (BYOS)" en lugar de `destinationContainerUrl`, donde se pueden limpiar los blobs.
diarization	DiarizationProperties		DiarizationProperties
displayFormWordLevelTimestampsEnabled	boolean		Valor que indica si se solicitan marcas de tiempo de nivel de palabra para el formulario para mostrar. El valor predeterminado es `false`.
durationMilliseconds	integer (int64)	0	La duración en milisegundos de la transcripción. No se admiten duraciones superiores a 2^53-1 para garantizar la compatibilidad con enteros de JavaScript.
error	EntityError		EntityError
languageIdentification	LanguageIdentificationProperties		LanguageIdentificationProperties
profanityFilterMode	ProfanityFilterMode		ProfanityFilterMode Modo de filtrado de palabras soeces.
punctuationMode	PunctuationMode		PuntuaciónMode Modo que se usa para la puntuación.
timeToLiveHours	integer (int32)		Cuánto tiempo se conservará la transcripción en el sistema después de que se haya completado. Una vez que la transcripción alcance el tiempo de vida después de la finalización (exitosa o fallida), se eliminará automáticamente. Nota: Al usar BYOS (traiga su propio almacenamiento), también se eliminarán los archivos de resultados de la cuenta de almacenamiento propiedad del cliente. Use destinationContainerUrl para especificar un contenedor independiente para los archivos de resultados que no se eliminarán cuando expire timeToLive, o recupere los archivos de resultados a través de la API y guárdelos según sea necesario. La duración admitida más corta es de 6 horas, la duración admitida más larga es de 31 días. 2 días (48 horas) es el valor predeterminado recomendado cuando los datos se consumen directamente.
wordLevelTimestampsEnabled	boolean		Valor que indica si se solicitan marcas de tiempo de nivel de palabra. El valor predeterminado es `false`.

Compartir a través de

Transcriptions - Submit

Parámetros de identificador URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Seguridad

Ocp-Apim-Subscription-Key

Ejemplos

Create a transcription for URIs

Solicitud de ejemplo

Respuesta de muestra

Create a transcription from blob container

Solicitud de ejemplo

Respuesta de muestra

Create a transcription with language identification

Solicitud de ejemplo

Respuesta de muestra

Create a transcription with multispeaker diarization

Solicitud de ejemplo

Respuesta de muestra

Definiciones

DetailedErrorCode

DiarizationProperties

EntityError

EntityReference

Error

ErrorCode

InnerError

LanguageIdentificationMode

LanguageIdentificationProperties

ProfanityFilterMode

PunctuationMode

Status

Transcription

TranscriptionLinks

TranscriptionProperties

Observaciones