Condividi tramite


Transcriptions - Get

Ottiene la trascrizione identificata dall'ID specificato.

GET {endpoint}/speechtotext/v3.1/transcriptions/{id}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
endpoint
path True

string

Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://westus.api.cognitive.microsoft.com).

id
path True

string

uuid

Identificatore della trascrizione.

Risposte

Nome Tipo Descrizione
200 OK

Transcription

OK

Intestazioni

Retry-After: integer

Other Status Codes

Error

Si è verificato un errore.

Sicurezza

Ocp-Apim-Subscription-Key

Specificare qui la chiave dell'account di Servizi cognitivi.

Tipo: apiKey
In: header

Authorization

Fornire un token di accesso dal token JWT restituito dal servizio token di sicurezza di questa area. Assicurarsi di aggiungere l'ambito di gestione al token aggiungendo la stringa di query seguente all'URL stS: ?scope=speechservicesmanagement

Tipo: apiKey
In: header

Esempio

Get a transcription

Esempio di richiesta

GET {endpoint}/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683

Risposta di esempio

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/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"
  }
}

Definizioni

Nome Descrizione
DetailedErrorCode

DetailedErrorCode

DiarizationProperties

Proprietà diarizzazione

DiarizationSpeakersProperties

DiarizationSpeakersProperties

EntityError

EntityError

EntityReference

EntityReference

Error

Errore

ErrorCode

ErrorCode

InnerError

InnerError

LanguageIdentificationProperties

LanguageIdentificationProperties

ProfanityFilterMode

ProfanityFilterMode

PunctuationMode

PunctuationMode

Status

Stato

Transcription

Trascrizione

TranscriptionLinks

TranscriptionLinks

TranscriptionProperties

Proprietà di trascrizione

DetailedErrorCode

DetailedErrorCode

Nome Tipo Descrizione
DataImportFailed

string

Importazione dati non riuscita.

DeleteNotAllowed

string

Eliminazione non consentita.

DeployNotAllowed

string

Distribuzione non consentita.

DeployingFailedModel

string

Distribuzione del modello non riuscito.

EmptyRequest

string

Richiesta vuota.

EndpointCannotBeDefault

string

L'endpoint non può essere predefinito.

EndpointNotUpdatable

string

Endpoint non aggiornabile.

EndpointWithoutLogging

string

Endpoint senza registrazione.

ExceededNumberOfRecordingsUris

string

È stato superato il numero di URI delle registrazioni.

FailedDataset

string

Set di dati non riuscito.

Forbidden

string

Non consentito.

InUseViolation

string

Violazione dell'uso.

InaccessibleCustomerStorage

string

Archiviazione dei clienti inaccessibile.

InvalidAdaptationMapping

string

Mapping di adattamento non valido.

InvalidBaseModel

string

Modello di base non valido.

InvalidCallbackUri

string

URI di callback non valido.

InvalidCollection

string

Raccolta non valida.

InvalidDataset

string

Set di dati non valido.

InvalidDocument

string

Documento non valido.

InvalidDocumentBatch

string

Batch di documenti non valido.

InvalidLocale

string

Impostazioni locali non valide.

InvalidLogDate

string

Data del log non valida.

InvalidLogEndTime

string

Ora di fine del log non valida.

InvalidLogId

string

ID di log non valido.

InvalidLogStartTime

string

Ora di inizio del log non valida.

InvalidModel

string

Modello non valido.

InvalidModelUri

string

URI del modello non valido.

InvalidParameter

string

Parametro non valido.

InvalidParameterValue

string

Valore del parametro non valido.

InvalidPayload

string

Payload non valido.

InvalidPermissions

string

Autorizzazioni non valide.

InvalidPrerequisite

string

Prerequisito non valido.

InvalidProductId

string

ID prodotto non valido.

InvalidProject

string

Progetto non valido.

InvalidProjectKind

string

Tipo di progetto non valido.

InvalidRecordingsUri

string

URI registrazioni non valide.

InvalidRequestBodyFormat

string

Formato del corpo della richiesta non valido.

InvalidSasValidityDuration

string

Durata di validità della firma di accesso condiviso non valida.

InvalidSkipTokenForLogs

string

Token skip non valido per i log.

InvalidSubscription

string

Sottoscrizione non valida.

InvalidTest

string

Test non valido.

InvalidTimeToLive

string

Tempo non valido per la durata.

InvalidTopForLogs

string

Top non valido per i log.

InvalidTranscription

string

Trascrizione non valida.

InvalidWebHookEventKind

string

Tipo di evento web hook non valido.

MissingInputRecords

string

Record di input mancanti.

ModelDeploymentNotCompleteState

string

Lo stato della distribuzione del modello non è completo.

ModelDeprecated

string

Modello deprecato.

ModelExists

string

Il modello esiste.

ModelMismatch

string

Mancata corrispondenza del modello.

ModelNotDeployable

string

Modello non distribuibile.

ModelVersionIncorrect

string

Versione del modello non corretta.

NoUtf8WithBom

string

Nessun utf8 con bom.

OnlyOneOfUrlsOrContainerOrDataset

string

Solo uno degli URL o del contenitore o del set di dati.

ProjectGenderMismatch

string

Mancata corrispondenza del genere del progetto.

QuotaViolation

string

Violazione della quota.

SingleDefaultEndpoint

string

Singolo endpoint predefinito.

SkuLimitsExist

string

Esistono limiti di SKU.

SubscriptionNotFound

string

Sottoscrizione non trovata.

UnexpectedError

string

Errore imprevisto.

UnsupportedClassBasedAdaptation

string

Adattamento basato sulla classe non supportato.

UnsupportedDelta

string

Delta non supportato.

UnsupportedDynamicConfiguration

string

Configurazione dinamica non supportata.

UnsupportedFilter

string

Filtro non supportato.

UnsupportedLanguageCode

string

Codice del linguaggio non supportato.

UnsupportedOrderBy

string

Ordine non supportato da.

UnsupportedPagination

string

Impaginazione non supportata.

UnsupportedTimeRange

string

Intervallo di tempo non supportato.

DiarizationProperties

Proprietà diarizzazione

Nome Tipo Descrizione
speakers

DiarizationSpeakersProperties

DiarizationSpeakersProperties

DiarizationSpeakersProperties

DiarizationSpeakersProperties

Nome Tipo Descrizione
maxCount

integer

Numero massimo di altoparlanti per la diarizzazione. Deve essere minore di 36 e maggiore o uguale alla proprietà minSpeakers.

minCount

integer

Suggerimento per il numero minimo di altoparlanti per la diarizzazione. Deve essere minore o uguale alla proprietà maxSpeakers.

EntityError

EntityError

Nome Tipo Descrizione
code

string

Codice di questo errore.

message

string

Messaggio per questo errore.

EntityReference

EntityReference

Nome Tipo Descrizione
self

string

Posizione dell'entità a cui si fa riferimento.

Error

Errore

Nome Tipo Descrizione
code

ErrorCode

ErrorCode
Codici di errore di alto livello.

details

Error[]

Dettagli aggiuntivi di supporto relativi all'errore e/o ai criteri previsti.

innerError

InnerError

InnerError
Nuovo formato di errore interno conforme alle linee guida per l'API Servizi cognitivi, disponibile in https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene le proprietà obbligatorie ErrorCode, message e proprietà facoltative di destinazione, details(coppia chiave-valore), errore interno(può essere annidato).

message

string

Messaggio di errore di alto livello.

target

string

Indica l'origine dell'errore. Ad esempio, si tratta di "documenti" o "ID documento" in caso di documento non valido.

ErrorCode

ErrorCode

Nome Tipo Descrizione
Conflict

string

Rappresentazione del codice di errore del conflitto.

Forbidden

string

Rappresentazione del codice di errore non consentito.

InternalCommunicationFailed

string

Rappresentazione del codice di errore della comunicazione interna non riuscita.

InternalServerError

string

Rappresentazione del codice di errore interno del server.

InvalidArgument

string

Rappresenta il codice di errore dell'argomento non valido.

InvalidRequest

string

Rappresenta il codice di errore della richiesta non valido.

NotAllowed

string

Rappresenta il codice di errore non consentito.

NotFound

string

Rappresentazione del codice di errore non trovato.

PipelineError

string

Rappresentazione del codice di errore della pipeline.

ServiceUnavailable

string

Rappresenta il codice di errore del servizio non disponibile.

TooManyRequests

string

Rappresenta il codice di errore troppe richieste.

Unauthorized

string

Rappresenta il codice di errore non autorizzato.

UnprocessableEntity

string

Rappresenta il codice di errore dell'entità non elaborabile.

UnsupportedMediaType

string

Rappresenta il codice di errore del tipo di supporto non supportato.

InnerError

InnerError

Nome Tipo Descrizione
code

DetailedErrorCode

DetailedErrorCode
Enumerazione dettagliata del codice di errore.

details

object

Dettagli aggiuntivi di supporto relativi all'errore e/o ai criteri previsti.

innerError

InnerError

InnerError
Nuovo formato di errore interno conforme alle linee guida per l'API Servizi cognitivi, disponibile in https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene le proprietà obbligatorie ErrorCode, message e proprietà facoltative di destinazione, details(coppia chiave-valore), errore interno(può essere annidato).

message

string

Messaggio di errore di alto livello.

target

string

Indica l'origine dell'errore. Ad esempio, si tratta di "documenti" o "ID documento" in caso di documento non valido.

LanguageIdentificationProperties

LanguageIdentificationProperties

Nome Tipo Descrizione
candidateLocales

string[]

Impostazioni locali candidate per l'identificazione della lingua (ad esempio ["en-US", "de-DE", "es-ES"]). È supportato almeno 2 e un massimo di 10 impostazioni locali candidate, incluse le impostazioni locali principali per la trascrizione.

speechModelMapping

<string,  EntityReference>

Mapping facoltativo delle impostazioni locali alle entità del modello di riconoscimento vocale. Se non viene specificato alcun modello per le impostazioni locali, viene usato il modello di base predefinito. Le chiavi devono essere impostazioni locali contenute nelle impostazioni locali candidate, i valori sono entità per i modelli delle rispettive impostazioni locali.

ProfanityFilterMode

ProfanityFilterMode

Nome Tipo Descrizione
Masked

string

Mascherare il contenuto volgare con * ad eccezione della prima lettera, ad esempio f**

None

string

Disabilitare il filtro per il contenuto volgare.

Removed

string

Rimuovere il contenuto volgare.

Tags

string

Aggiungere tag< XML "volgarity" /Contenuto volgare>

PunctuationMode

PunctuationMode

Nome Tipo Descrizione
Automatic

string

Punteggiatura automatica.

Dictated

string

Segni di punteggiatura dettati solo, ad esempio la punteggiatura esplicita.

DictatedAndAutomatic

string

Segni di punteggiatura dettati o punteggiatura automatica.

None

string

Nessuna punteggiatura.

Status

Stato

Nome Tipo Descrizione
Failed

string

L'operazione a esecuzione prolungata non è riuscita.

NotStarted

string

L'operazione a esecuzione prolungata non è ancora stata avviata.

Running

string

L'operazione a esecuzione prolungata è attualmente in elaborazione.

Succeeded

string

L'operazione a esecuzione prolungata è stata completata correttamente.

Transcription

Trascrizione

Nome Tipo Descrizione
contentContainerUrl

string

URL per un contenitore BLOB di Azure che contiene i file audio. Un contenitore può avere una dimensione massima di 5 GB e un numero massimo di 10000 BLOB. Le dimensioni massime per un BLOB sono di 2,5 GB. La firma di accesso condiviso del contenitore deve contenere autorizzazioni 'r' (lettura) e 'l' (elenco). Questa proprietà non verrà restituita in una risposta.

contentUrls

string[]

Elenco di URL di contenuto per ottenere i file audio da trascrivere. Sono consentiti fino a 1000 URL. Questa proprietà non verrà restituita in una risposta.

createdDateTime

string

Timestamp al momento della creazione dell'oggetto. Il timestamp è codificato come formato di data e ora ISO 8601 ("AAAA-MM-GGThh:mm:ssZ", vedere https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

customProperties

object

Proprietà personalizzate di questa entità. La lunghezza massima consentita della chiave è di 64 caratteri, la lunghezza massima consentita è di 256 caratteri e il numero di voci consentite è 10.

dataset

EntityReference

EntityReference

description

string

Descrizione dell'oggetto .

displayName

string

Nome visualizzato dell'oggetto.

lastActionDateTime

string

Timestamp quando è stato immesso lo stato corrente. Il timestamp è codificato come formato di data e ora ISO 8601 ("AAAA-MM-GGThh:mm:ssZ", vedere https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

links

TranscriptionLinks

TranscriptionLinks

locale

string

Impostazioni locali dei dati contenuti. Se si usa l'identificazione della lingua, queste impostazioni locali vengono usate per trascrivere il parlato per cui non è stato possibile rilevare alcuna lingua.

model

EntityReference

EntityReference

project

EntityReference

EntityReference

properties

TranscriptionProperties

Proprietà di trascrizione

self

string

Posizione dell'entità.

status

Status

Stato
Descrivere lo stato corrente dell'API

TranscriptionLinks

Nome Tipo Descrizione
files

string

Percorso per ottenere tutti i file di questa entità. Per altri dettagli, vedere l'operazione "Transcriptions_ListFiles".

TranscriptionProperties

Proprietà di trascrizione

Nome Tipo Descrizione
channels

integer[]

Raccolta dei numeri di canale richiesti. Nel caso predefinito, vengono considerati i canali 0 e 1.

destinationContainerUrl

string

Contenitore di destinazione richiesto.

Commenti

Quando un contenitore di destinazione viene usato in combinazione con , timeToLivei metadati di una trascrizione verranno eliminati normalmente, ma i dati archiviati nel contenitore di destinazione, inclusi i risultati della trascrizione, rimarranno invariati, perché non sono necessarie autorizzazioni di eliminazione per questo contenitore.
Per supportare la pulizia automatica, configurare la durata dei BLOB nel contenitore o usare "Bring Your Own Storage (BYOS)" anziché destinationContainerUrl, dove è possibile pulire i BLOB.

diarization

DiarizationProperties

Proprietà diarizzazione

diarizationEnabled

boolean

Valore che indica se è richiesta la diarizzazione (identificazione voce). Il valore predefinito è false. Se questo campo è impostato su true e il sistema di diarizzazione migliorato è configurato specificando DiarizationProperties, il sistema di diarizzazione migliorato fornirà la diarizzazione per un intervallo configurabile di altoparlanti. Se questo campo è impostato su true e il sistema di diarizzazione migliorato non è abilitato (non specificando DiarizationProperties), il sistema di diarizzazione di base distinguirà tra un massimo di due altoparlanti. Non vengono applicati addebiti aggiuntivi per la diarizzazione di base.

Il sistema di diarizzazione di base è deprecato e verrà rimosso nella prossima versione principale dell'API. Questa diarizationEnabled impostazione verrà rimossa anche.

displayFormWordLevelTimestampsEnabled

boolean

Valore che indica se vengono richiesti timestamp a livello di parola per il modulo di visualizzazione. Il valore predefinito è false.

duration

string

Durata della trascrizione. La durata viene codificata come durata ISO 8601 ("PnYnMnDTnHnMnS", vedere https://en.wikipedia.org/wiki/ISO_8601#Durations).

email

string

Indirizzo di posta elettronica a cui inviare notifiche tramite posta elettronica nel caso in cui l'operazione venga completata. Il valore verrà rimosso dopo aver inviato correttamente il messaggio di posta elettronica.

error

EntityError

EntityError

languageIdentification

LanguageIdentificationProperties

LanguageIdentificationProperties

profanityFilterMode

ProfanityFilterMode

ProfanityFilterMode
Modalità di filtro per contenuto volgare.

punctuationMode

PunctuationMode

PunctuationMode
Modalità utilizzata per la punteggiatura.

timeToLive

string

Per quanto tempo la trascrizione verrà mantenuta nel sistema dopo il completamento. Una volta raggiunta la durata della trascrizione dopo il completamento (esito positivo o negativo), la trascrizione verrà eliminata automaticamente. Non impostando questo valore o impostandolo su 0, l'eliminazione automatica verrà disabilitata. La durata supportata più lunga è di 31 giorni. La durata viene codificata come durata ISO 8601 ("PnYnMnDTnHnMnS", vedere https://en.wikipedia.org/wiki/ISO_8601#Durations).

wordLevelTimestampsEnabled

boolean

Valore che indica se vengono richiesti timestamp a livello di parola. Il valore predefinito è false.