Transcriptions - Get

Reference

Služba:: Azure AI Services

Verze rozhraní API:: v3.2-preview.2

Získá přepis identifikovaný podle daného ID.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://westus.api.cognitive.microsoft.com).
id	path	True	string uuid	Identifikátor přepisu.

Odpovědi

Name	Typ	Description
200 OK	Transcription	OK Hlavičky Retry-After: integer
Other Status Codes	Error	Došlo k chybě.

Name

Typ

Description

200 OK

Transcription

Hlavičky

Retry-After: integer

Other Status Codes

Error

Došlo k chybě.

Zabezpečení

Ocp-Apim-Subscription-Key

Sem zadejte klíč účtu služeb Cognitive Services.

Typ: apiKey
V: header

Authorization

Zadejte přístupový token z JWT vrácený službou STS této oblasti. Nezapomeňte do tokenu přidat obor správy přidáním následujícího řetězce dotazu na adresu URL služby STS: ?scope=speechservicesmanagement.

Typ: apiKey
V: header

Příklady

Get a transcription

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 200

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

Definice

Name	Description
DetailedErrorCode	Podrobný kód chyby
DiarizationProperties	DiarizationProperties
DiarizationSpeakersProperties	DiarizationSpeakersVlastnosti
EntityError	Chyba entity
EntityReference	EntityReference
Error	Chyba
ErrorCode	ErrorCode
InnerError	Vnitřní chyba
LanguageIdentificationMode	LanguageIdentificationMode
LanguageIdentificationProperties	LanguageIdentificationProperties
ProfanityFilterMode	Vulgární výrazyFilterMode
PunctuationMode	Interpunkční znaméně
Status	Stav
Transcription	Transkripce
TranscriptionLinks	Odkazy na přepis
TranscriptionProperties	Vlastnosti přepisu

DetailedErrorCode

Podrobný kód chyby

Name	Typ	Description
DataImportFailed	string	Import dat se nezdařil.
DeleteNotAllowed	string	Odstranění není povoleno.
DeployNotAllowed	string	Nasazení není povoleno.
DeployingFailedModel	string	Nasazení modelu, který selhal
EmptyRequest	string	Prázdný požadavek.
EndpointCannotBeDefault	string	Koncový bod nemůže být výchozí.
EndpointNotUpdatable	string	Koncový bod není aktualizovatelný.
EndpointWithoutLogging	string	Koncový bod bez protokolování
ExceededNumberOfRecordingsUris	string	Byl překročen počet nahrávek uris.
FailedDataset	string	Datová sada selhala.
Forbidden	string	Zakázáno.
InUseViolation	string	Porušení používání.
InaccessibleCustomerStorage	string	Nepřístupné úložiště zákazníka
InvalidAdaptationMapping	string	Neplatné mapování adaptace
InvalidBaseModel	string	Neplatný základní model
InvalidCallbackUri	string	Neplatný identifikátor URI zpětného volání
InvalidCollection	string	Neplatná kolekce.
InvalidDataset	string	Neplatná datová sada
InvalidDocument	string	Neplatný dokument
InvalidDocumentBatch	string	Neplatná dávka dokumentu.
InvalidLocale	string	Neplatné národní prostředí.
InvalidLogDate	string	Neplatné datum protokolu.
InvalidLogEndTime	string	Neplatný čas ukončení protokolu.
InvalidLogId	string	Neplatné ID protokolu
InvalidLogStartTime	string	Neplatný čas spuštění protokolu.
InvalidModel	string	Neplatný model
InvalidModelUri	string	Neplatný identifikátor URI modelu
InvalidParameter	string	Neplatný parametr
InvalidParameterValue	string	Neplatná hodnota parametru
InvalidPayload	string	Neplatná datová část
InvalidPermissions	string	Neplatná oprávnění.
InvalidPrerequisite	string	Neplatná podmínka.
InvalidProductId	string	Neplatné ID produktu
InvalidProject	string	Neplatný projekt
InvalidProjectKind	string	Neplatný druh projektu
InvalidRecordingsUri	string	Neplatný identifikátor URI nahrávek
InvalidRequestBodyFormat	string	Neplatný formát textu požadavku.
InvalidSasValidityDuration	string	Neplatná doba platnosti SAS.
InvalidSkipTokenForLogs	string	Neplatný token skip pro protokoly.
InvalidSourceAzureResourceId	string	Neplatné ID zdrojového prostředku Azure
InvalidSubscription	string	Neplatné předplatné
InvalidTest	string	Neplatný test
InvalidTimeToLive	string	Hodnota TTL (Time to Live) je neplatná.
InvalidTopForLogs	string	Neplatné top pro protokoly.
InvalidTranscription	string	Neplatný přepis.
InvalidWebHookEventKind	string	Neplatný druh události webhooku
MissingInputRecords	string	Chybí vstupní záznamy.
ModelCopyOperationExists	string	Existuje operace kopírování modelu.
ModelDeploymentNotCompleteState	string	Nasazení modelu není dokončeno.
ModelDeprecated	string	Model je zastaralý.
ModelExists	string	Model existuje.
ModelMismatch	string	Neshoda modelů.
ModelNotDeployable	string	Model nejde nasadit.
ModelVersionIncorrect	string	Nesprávná verze modelu.
NoUtf8WithBom	string	No utf8 s bom.
OnlyOneOfUrlsOrContainerOrDataset	string	Pouze jednu z adres URL nebo kontejner nebo datovou sadu.
ProjectGenderMismatch	string	Neshoda pohlaví v projektu.
QuotaViolation	string	Porušení kvóty.
SingleDefaultEndpoint	string	Jeden výchozí koncový bod.
SkuLimitsExist	string	Existují omezení skladových položek.
SubscriptionNotFound	string	Předplatné se nenašlo.
UnexpectedError	string	Neočekávaná chyba.
UnsupportedClassBasedAdaptation	string	Nepodporovaná adaptace na základě třídy
UnsupportedDelta	string	Nepodporovaná rozdílová.
UnsupportedDynamicConfiguration	string	Nepodporovaná dynamická konfigurace
UnsupportedFilter	string	Nepodporovaný filtr
UnsupportedLanguageCode	string	Nepodporovaný kód jazyka
UnsupportedOrderBy	string	Nepodporované řazení podle.
UnsupportedPagination	string	Nepodporovaná stránkování.
UnsupportedTimeRange	string	Nepodporovaný časový rozsah.

DiarizationProperties

Name	Typ	Description
speakers	DiarizationSpeakersProperties	DiarizationSpeakersVlastnosti

DiarizationSpeakersProperties

DiarizationSpeakersVlastnosti

Name	Typ	Description
maxCount	integer	Maximální počet reproduktorů pro diarizaci. Musí být menší než 36 a větší nebo roven vlastnosti minSpeakers.
minCount	integer	Tip pro minimální počet reproduktorů pro diarizaci. Musí být menší nebo rovno vlastnosti maxSpeakers.

EntityError

Chyba entity

Name	Typ	Description
code	string	Kód této chyby.
message	string	Zpráva o této chybě.

EntityReference

Name	Typ	Description
self	string	Umístění odkazované entity

Error

Chyba

Name	Typ	Description
code	ErrorCode	ErrorCode Kódy chyb vysoké úrovně.
details	Error[]	Další podpůrné podrobnosti týkající se chyby nebo očekávaných zásad
innerError	InnerError	Vnitřní chyba Nový formát vnitřních chyb, který odpovídá pokynům k rozhraní API služeb Cognitive Services, které jsou k dispozici na adrese https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Obsahuje požadované vlastnosti ErrorCode, message a optional properties target, details(key value pair), inner error (to může být vnořené).
message	string	Chybová zpráva vysoké úrovně.
target	string	Zdroj chyby. V případě neplatného dokumentu by to bylo například "dokumenty" nebo "id dokumentu".

ErrorCode

Name	Typ	Description
Conflict	string	Představuje kód chyby konfliktu.
Forbidden	string	Představuje kód chyby Zakázáno.
InternalCommunicationFailed	string	Představuje kód chyby vnitřní komunikace, která selhala.
InternalServerError	string	Představuje kód vnitřní chyby serveru.
InvalidArgument	string	Představuje neplatný kód chyby argumentu.
InvalidRequest	string	Představuje neplatný kód chyby požadavku.
NotAllowed	string	Představuje nepovolený kód chyby.
NotFound	string	Představuje kód chyby nenalezena.
PipelineError	string	Představuje kód chyby kanálu.
ServiceUnavailable	string	Představuje kód chyby nedostupné služby.
TooManyRequests	string	Představuje kód chyby příliš mnoho požadavků.
Unauthorized	string	Představuje neoprávněný kód chyby.
UnprocessableEntity	string	Představuje kód chyby nezpracované entity.
UnsupportedMediaType	string	Představuje kód chyby nepodporovaného typu média.

InnerError

Vnitřní chyba

Name	Typ	Description
code	DetailedErrorCode	Podrobný kód chyby Podrobný výčet kódu chyby
details	object	Další podpůrné podrobnosti týkající se chyby nebo očekávaných zásad
innerError	InnerError	Vnitřní chyba Nový formát vnitřních chyb, který odpovídá pokynům k rozhraní API služeb Cognitive Services, které jsou k dispozici na adrese https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Obsahuje požadované vlastnosti ErrorCode, message a optional properties target, details(key value pair), inner error (to může být vnořené).
message	string	Chybová zpráva vysoké úrovně.
target	string	Zdroj chyby. V případě neplatného dokumentu by to bylo například "dokumenty" nebo "id dokumentu".

LanguageIdentificationMode

Name	Typ	Description
Continuous	string	Průběžná identifikace jazyka (výchozí).
Single	string	Identifikace v jednom jazyce.

LanguageIdentificationProperties

Name	Typ	Default value	Description
candidateLocales	string[]		Kandidátské národní prostředí pro identifikaci jazyka (například ["en-US", "de-DE", "es-ES"]). Podporují se minimálně 2 a maximálně 10 kandidátských národních prostředí, včetně hlavního národního prostředí pro přepis.
mode	LanguageIdentificationMode	Continuous	LanguageIdentificationMode Režim používaný k identifikaci jazyka.
speechModelMapping	<string, EntityReference>		Volitelné mapování národních prostředí na entity modelu řeči. Pokud pro národní prostředí není zadaný žádný model, použije se výchozí základní model. Klíče musí být národní prostředí obsažená v kandidátských národních prostředích, hodnoty jsou entity pro modely příslušných národních prostředí.

ProfanityFilterMode

Vulgární výrazyFilterMode

Name	Typ	Description
Masked	string	Maskujte vulgární výrazy * s výjimkou prvního písmene, např. f***
None	string	Zakažte filtrování vulgárních výrazů.
Removed	string	Odstraňte vulgární výrazy.
Tags	string	Přidání "vulgárních" značek< XML nebo vulgárních výrazů>

PunctuationMode

Interpunkční znaméně

Name	Typ	Description
Automatic	string	Automatická interpunkce.
Dictated	string	Pouze diktovaná interpunkční znaménka, tj. explicitní interpunkční znaménka.
DictatedAndAutomatic	string	Diktované interpunkční znaménka nebo automatická interpunkční znaménka.
None	string	Bez interpunkce.

Status

Stav

Name	Typ	Description
Failed	string	Dlouhotrvající operace selhala.
NotStarted	string	Dlouhotrvající operace se ještě nespustila.
Running	string	Dlouhotrvající operace se právě zpracovává.
Succeeded	string	Dlouhotrvající operace byla úspěšně dokončena.

Transcription

Transkripce

Name	Typ	Description
contentContainerUrl	string	Adresa URL kontejneru objektů blob Azure, který obsahuje zvukové soubory. Kontejner může mít maximální velikost 5 GB a maximální počet 10 000 objektů blob. Maximální velikost objektu blob je 2,5 GB. Sas kontejneru by měl obsahovat oprávnění r (čtení) a l (seznam). Tato vlastnost nebude v odpovědi vrácena.
contentUrls	string[]	Seznam adres URL obsahu pro získání zvukových souborů k přepisu. Je povoleno až 1 000 adres URL. Tato vlastnost nebude v odpovědi vrácena.
createdDateTime	string	Časové razítko, kdy byl objekt vytvořen. Časové razítko je kódované jako formát data a času ISO 8601 ("RRRR-MM-DDThh:mm:ssZ", viz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties	object	Vlastní vlastnosti této entity. Maximální povolená délka klíče je 64 znaků, maximální povolená délka hodnoty je 256 znaků a počet povolených položek je 10.
dataset	EntityReference	EntityReference
description	string	Popis objektu.
displayName	string	Zobrazovaný název objektu.
lastActionDateTime	string	Časové razítko, kdy byl zadán aktuální stav. Časové razítko je kódované jako formát data a času ISO 8601 ("RRRR-MM-DDThh:mm:ssZ", viz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	TranscriptionLinks	Odkazy na přepis
locale	string	Národní prostředí obsažených dat. Pokud se použije identifikace jazyka, použije se toto národní prostředí k přepisu řeči, pro kterou nelze rozpoznat žádný jazyk.
model	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	TranscriptionProperties	Vlastnosti přepisu
self	string	Umístění této entity
status	Status	Stav Popis aktuálního stavu rozhraní API

TranscriptionLinks

Odkazy na přepis

Name	Typ	Description
files	string	Umístění pro získání všech souborů této entity Další podrobnosti najdete v části operace "Transcriptions_ListFiles".

TranscriptionProperties

Vlastnosti přepisu

Name	Typ	Description
channels	integer[]	Kolekce požadovaných čísel kanálů. Ve výchozím případě se zvažují kanály 0 a 1.
destinationContainerUrl	string	Požadovaný cílový kontejner. Poznámky Pokud se cílový kontejner použije v kombinaci s `timeToLive`, metadata přepisu se odstraní normálně, ale data uložená v cílovém kontejneru, včetně výsledků přepisu, zůstanou nedotčená, protože pro tento kontejner nejsou vyžadována žádná oprávnění k odstranění. Pokud chcete podporovat automatické čištění, buď nakonfigurujte životnost objektů blob v kontejneru, nebo místo použijte možnost Přineste si vlastní úložiště (BYOS) místo , `destinationContainerUrl`kde je možné objekty blob vyčistit.
diarization	DiarizationProperties	DiarizationProperties
diarizationEnabled	boolean	Hodnota označující, jestli se vyžaduje diarizace (identifikace mluvčího). Výchozí hodnota je `false`. Pokud je toto pole nastaveno na hodnotu true a vylepšený systém diarizace je nakonfigurován zadáním `DiarizationProperties`, vylepšený systém diarizace zajistí diarizaci pro konfigurovatelný rozsah reproduktorů. Pokud je toto pole nastaveno na hodnotu true a vylepšený systém diarizace není povolen (neurčuje `DiarizationProperties`), systém základní diarizace bude rozlišovat až mezi dvěma mluvčími. Za základní diarizaci se neúčtují žádné další poplatky. Systém základní diarizace je zastaralý a v další hlavní verzi rozhraní API se odebere. Toto `diarizationEnabled` nastavení bude také odebráno.
displayFormWordLevelTimestampsEnabled	boolean	Hodnota označující, zda jsou požadována časová razítka na úrovni slov pro formulář pro zobrazení. Výchozí hodnota je `false`.
duration	string	Doba trvání přepisu. Doba trvání je kódovaná jako doba trvání ISO 8601 ("PnYnMnDTnHnMnS", viz https://en.wikipedia.org/wiki/ISO_8601#Durations).
email	string	E-mailová adresa, na kterou se budou odesílat e-mailová oznámení pro případ, že se operace dokončí. Hodnota se po úspěšném odeslání e-mailu odebere.
error	EntityError	Chyba entity
languageIdentification	LanguageIdentificationProperties	LanguageIdentificationProperties
profanityFilterMode	ProfanityFilterMode	Vulgární výrazyFilterMode Režim filtrování vulgárních výrazů.
punctuationMode	PunctuationMode	Interpunkční znaméně Režim používaný pro interpunkci.
timeToLive	string	Jak dlouho se bude přepis uchovávat v systému po jeho dokončení. Jakmile přepis po dokončení dosáhne hodnoty TTL (úspěšný nebo neúspěšný), automaticky se odstraní. Nenastavíte-li tuto hodnotu nebo ji nenastavíte na hodnotu 0, zakážete automatické odstranění. Nejdelší podporovaná doba trvání je 31 dnů. Doba trvání je kódovaná jako doba trvání ISO 8601 ("PnYnMnDTnHnMnS", viz https://en.wikipedia.org/wiki/ISO_8601#Durations).
wordLevelTimestampsEnabled	boolean	Hodnota označující, jestli jsou požadována časová razítka na úrovni slov. Výchozí hodnota je `false`.

Sdílet prostřednictvím

Transcriptions - Get

Parametry identifikátoru URI

Odpovědi

Zabezpečení

Ocp-Apim-Subscription-Key

Authorization

Příklady

Get a transcription

Ukázkový požadavek

Ukázková odpověď

Definice

DetailedErrorCode

DiarizationProperties

DiarizationSpeakersProperties

EntityError

EntityReference

Error

ErrorCode

InnerError

LanguageIdentificationMode

LanguageIdentificationProperties

ProfanityFilterMode

PunctuationMode

Status

Transcription

TranscriptionLinks

TranscriptionProperties

Poznámky

Další materiály