Transcriptions - Get

Reference

Služba:: Azure AI Services

Verze rozhraní API:: 2024-11-15

Získá přepis identifikovaný daným ID.

GET {endpoint}/speechtotext/transcriptions/{id}?api-version=2024-11-15

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.
api-version	query	True	string	Požadovaná verze rozhraní API.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
Ocp-Apim-Subscription-Key	True	string	Tady zadejte svůj klíč účtu služeb Cognitive Services.

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

Tady zadejte svůj klíč účtu služeb Cognitive Services.

Typ: apiKey
V: header

Příklady

Get a transcription

Ukázkový požadavek

HTTP

GET {endpoint}/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683?api-version=2024-11-15

Ukázková odpověď

Stavový kód:: 200

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683?api-version=2024-11-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=2024-11-15"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?api-version=2024-11-15"
  },
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48,
    "durationMilliseconds": 42000
  },
  "status": "Succeeded"
}

Definice

Name	Description
DetailedErrorCode	DetailedErrorCode
DiarizationProperties	DiarizationProperties
EntityError	EntityError
EntityReference	EntityReference
Error	Chyba
ErrorCode	Kód chyby
InnerError	Vnitřní chyba
LanguageIdentificationMode	LanguageIdentificationMode
LanguageIdentificationProperties	LanguageIdentificationProperties
ProfanityFilterMode	Vulgární výrazFilterMode
PunctuationMode	Interpunkční znaméčko
Status	Stav
Transcription	Transkripce
TranscriptionLinks	Přepislinky
TranscriptionProperties	PřepisProperties

DetailedErrorCode

Name	Typ	Description
AudioLengthLimitExceeded	string	Zvukový soubor je delší než maximální povolená doba trvání.
BadChannelConfiguration	string	Mezi zvukovými kanály v datech, konfigurací nebo požadavky aplikace se neshoduje.
DataImportFailed	string	Import dat se nezdařil.
DeleteNotAllowed	string	Odstranění není povoleno.
DeployNotAllowed	string	Nasazení není povoleno.
DeployingFailedModel	string	Nasazení neúspěšného modelu
EmptyAudioFile	string	Zvukový soubor je prázdný.
EmptyRequest	string	Prázdný požadavek.
EndpointCannotBeDefault	string	Koncový bod nemůže být výchozí.
EndpointLoggingNotSupported	string	Protokolování koncového bodu se nepodporuje.
EndpointNotUpdatable	string	Koncový bod nejde aktualizovat.
EndpointWithoutLogging	string	Koncový bod bez protokolování
ExceededNumberOfRecordingsUris	string	Byl překročen počet nahrávek.
FailedDataset	string	Datová sada se nezdařila.
Forbidden	string	Zakázaný.
InUseViolation	string	V narušení používání.
InaccessibleCustomerStorage	string	Nepřístupné úložiště zákazníka
InvalidAdaptationMapping	string	Neplatné mapování adaptací
InvalidAudioFormat	string	Formát vstupního zvuku není podporován.
InvalidBaseModel	string	Neplatný základní model
InvalidCallbackUri	string	Neplatný identifikátor URI zpětného volání.
InvalidChannelSpecification	string	Výběr kanálů v žádosti o přepis se nepodporuje (například 0 ani 1 nebylo vybráno.)
InvalidChannels	string	Neplatné kanály.
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ý požadavek.
InvalidProductId	string	Neplatné ID produktu
InvalidProject	string	Neplatný projekt.
InvalidProjectKind	string	Neplatný druh projektu.
InvalidRecordingsUri	string	Identifikátor URI pro neplatné nahrávky
InvalidRequestBodyFormat	string	Neplatný formát textu požadavku
InvalidSasValidityDuration	string	Neplatná doba platnosti SAS.
InvalidSkipTokenForLogs	string	Neplatný token pro přeskočení protokolů
InvalidSourceAzureResourceId	string	Neplatné ID zdroje prostředku Azure
InvalidSubscription	string	Neplatné předplatné
InvalidTest	string	Neplatný test.
InvalidTimeToLive	string	Neplatný čas naživo.
InvalidTopForLogs	string	Neplatný horní okraj pro protokoly.
InvalidTranscription	string	Neplatný přepis
InvalidWebHookEventKind	string	Neplatný druh události webhooku
MissingInputRecords	string	Chybí vstupní záznamy.
ModelCopyAuthorizationExpired	string	Platnost modeluCopyAuthorization vypršela.
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	Verze modelu není správná.
MultipleLanguagesIdentified	string	Identifikace jazyka rozpoznala více jazyků. Nelze určit žádný dominantní jazyk.
NoLanguageIdentified	string	Identifikace jazyka nerozpoznala žádný jazyk.
NoUtf8WithBom	string	No utf8 with bom.
OnlyOneOfUrlsOrContainerOrDataset	string	Pouze jedna z adres URL nebo kontejneru nebo datové sady.
ProjectGenderMismatch	string	Neshoda pohlaví projektu
QuotaViolation	string	Porušení kvóty
SingleDefaultEndpoint	string	Jeden výchozí koncový bod
SkuLimitsExist	string	Existují omezení skladové položky.
SubscriptionNotFound	string	Předplatné se nenašlo.
UnexpectedError	string	Neočekávaná chyba
UnsupportedClassBasedAdaptation	string	Nepodporovaná úprava založená na třídách.
UnsupportedDelta	string	Nepodporovaný rozdíl.
UnsupportedDynamicConfiguration	string	Nepodporovaná dynamická konfigurace
UnsupportedFilter	string	Nepodporovaný filtr
UnsupportedLanguageCode	string	Nepodporovaný kód jazyka
UnsupportedOrderBy	string	Nepodporované pořadí podle.
UnsupportedPagination	string	Nepodporované stránkování
UnsupportedTimeRange	string	Nepodporovaný časový rozsah

DiarizationProperties

Name	Typ	Description
enabled	boolean	Hodnota označující, jestli je povolená diarizace mluvčího.
maxSpeakers	integer	Tip pro maximální počet reproduktorů pro diarizaci. Musí být větší než 1 a menší než 36.

EntityError

Name	Typ	Description
code	string	Kód této chyby.
message	string	Zpráva pro tuto chybu.

EntityReference

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

Error

Chyba

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

ErrorCode

Kód chyby

Name	Typ	Description
Conflict	string	Představuje kód chyby konfliktu.
Forbidden	string	Představuje zakázaný kód chyby.
InternalCommunicationFailed	string	Představuje kód chyby selhání interní komunikace.
InternalServerError	string	Představuje kód chyby 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 kód chyby, který není povolený.
NotFound	string	Představuje kód chyby, který nebyl nalezen.
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š velkého počtu požadavků.
Unauthorized	string	Představuje neautorizovaný kód chyby.
UnprocessableEntity	string	Představuje nezpracovaný kód chyby entity.
UnsupportedMediaType	string	Představuje nepodporovaný kód chyby typu média.

InnerError

Vnitřní chyba

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

LanguageIdentificationMode

Name	Typ	Description
Continuous	string	Průběžná identifikace jazyka (výchozí).
Single	string	Identifikace jednoho jazyka. Pokud nelze identifikovat žádný jazyk, vrátí se uživateli kód chyby NoLanguageIdentified. Pokud existuje nejednoznačnost mezi více jazyky, vrátí se uživateli kód chyby MultipleLanguagesIdentified.

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"]). Pro průběžný režim se podporuje 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. Pro identifikaci jednoho jazyka není maximální počet kandidátských národních prostředí nevázaný.
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ýrazFilterMode

Name	Typ	Description
Masked	string	Maskujte vulgární výraz * s výjimkou prvního písmena, 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í značek XML "vulgárních výrazů"</vulgárních výrazů>

PunctuationMode

Interpunkční znaméčko

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

Status

Stav

Name	Typ	Description
Failed	string	Dlouhotrvající operace se nezdařila.
NotStarted	string	Dlouhotrvající operace ještě nebyla spuštěna.
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 1 0000 objektů blob. Maximální velikost objektu blob je 2,5 GB. Sas kontejneru by měl obsahovat oprávnění r (read) a l (list). Tato vlastnost nebude vrácena v odpovědi.
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 vrácena v odpovědi.
createdDateTime	string	Časové razítko při vytvoření objektu. Časové razítko je kódováno 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 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ódováno 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	Přepislinky
locale	string	Národní prostředí obsažených dat. Pokud se používá identifikace jazyka, použije se toto národní prostředí k přepisu řeči, pro kterou nelze rozpoznat žádný jazyk.
model	EntityReference	EntityReference
properties	TranscriptionProperties	PřepisProperties
self	string	Umístění této entity.
status	Status	Stav Popište aktuální stav rozhraní API.

TranscriptionLinks

Přepislinky

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

TranscriptionProperties

PřepisProperties

Name	Typ	Default value	Description
channels	integer[]		Kolekce požadovaných čísel kanálů. Ve výchozím případě se považují kanály 0 a 1.
destinationContainerUrl	string		Požadovaný cílový kontejner. Poznámky Při použití cílového kontejneru v kombinaci s `timeToLive`se metadata přepisu 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 nutná žádná oprávnění k odstranění. Pokud chcete podporovat automatické vyčištění, buď nakonfigurujte životnost objektů blob v kontejneru, nebo místo `destinationContainerUrl`použijte funkci Přineste si vlastní úložiště (BYOS), kde je možné objekty blob vyčistit.
diarization	DiarizationProperties		DiarizationProperties
displayFormWordLevelTimestampsEnabled	boolean		Hodnota označující, zda jsou požadovány časové razítka na úrovni slova pro formulář pro zobrazení. Výchozí hodnota je `false`.
durationMilliseconds	integer	0	Doba trvání v milisekundách přepisu. Doba trvání větší než 2^53-1 není podporována, aby byla zajištěna kompatibilita s celými čísly Jazyka JavaScript.
error	EntityError		EntityError
languageIdentification	LanguageIdentificationProperties		LanguageIdentificationProperties
profanityFilterMode	ProfanityFilterMode		Vulgární výrazFilterMode Režim filtrování vulgárních výrazů
punctuationMode	PunctuationMode		Interpunkční znaméčko Režim používaný pro interpunkci.
timeToLiveHours	integer		Jak dlouho se přepis bude uchovávat v systému po jeho dokončení. Jakmile přepis dosáhne doby, po dokončení (úspěšné nebo neúspěšné), automaticky se odstraní. Poznámka: Při použití BYOS (přineste si vlastní úložiště) se také odstraní výsledné soubory účtu úložiště vlastněného zákazníkem. Použijte buď destinationContainerUrl k určení samostatného kontejneru pro výsledné soubory, které nebudou odstraněny při vypršení časového limitu timeToLive, nebo načíst výsledné soubory prostřednictvím rozhraní API a podle potřeby je uložit. Nejkratší podporovaná doba trvání je 6 hodin, nejdelší podporovaná doba trvání je 31 dní. 2 dny (48 hodin) je doporučená výchozí hodnota, když se data spotřebovávají přímo.
wordLevelTimestampsEnabled	boolean		Hodnota označující, zda jsou požadovány časová razítka na úrovni slova. Výchozí hodnota je `false`.

Sdílet prostřednictvím

Transcriptions - Get

Parametry identifikátoru URI

Hlavička požadavku

Odpovědi

Zabezpečení

Ocp-Apim-Subscription-Key

Příklady

Get a transcription

Ukázkový požadavek

Ukázková odpověď

Definice

DetailedErrorCode

DiarizationProperties

EntityError

EntityReference

Error

ErrorCode

InnerError

LanguageIdentificationMode

LanguageIdentificationProperties

ProfanityFilterMode

PunctuationMode

Status

Transcription

TranscriptionLinks

TranscriptionProperties

Poznámky

Další materiály