Transcriptions - List Files

Reference

Služba:: Azure AI Services

Verze rozhraní API:: 2024-11-15

Získá soubory přepisu identifikované daným ID.

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

S volitelnými parametry:

GET {endpoint}/speechtotext/transcriptions/{id}/files?sasLifetimeMinutes={sasLifetimeMinutes}&skip={skip}&top={top}&filter={filter}&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.
filter	query		string	Výraz filtrování pro výběr podmnožina dostupných souborů. `- Supported properties: name, createdDateTime, kind. - Operators: - eq, ne are supported for all properties. - gt, ge, lt, le are supported for createdDateTime. - and, or, not are supported. - Example: filter=name eq 'myaudio.wav.json' and kind eq 'Transcription'`
sasLifetimeMinutes	query		integer int32	Tento parametr definuje dobu trvání v minutách, pro kterou má být platná adresa URL SAS. `The parameter can only be used for operations on speech resources that don't have BYOS enabled and transcriptions without a destinationContainerUrl. For speech resources that don't have BYOS enabled, the default SAS validity duration is 12 hours. For speech resources with BYOS and transcriptions with a destinationContainerUrl, returned urls do not contain an SAS token.`
skip	query		integer int32	Počet datových sad, které se přeskočí
top	query		integer int32	Počet datových sad, které budou zahrnuté po přeskočení

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	PaginatedFiles	OK Hlavičky Retry-After: integer
Other Status Codes	Error	Došlo k chybě.

Name

Typ

Description

200 OK

PaginatedFiles

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 all files

Get all transcription files the name of which starts with the specified string

Get all files

Ukázkový požadavek

HTTP

GET {endpoint}/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?sasLifetimeMinutes=360&skip=0&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z&api-version=2024-11-15

Ukázková odpověď

Stavový kód:: 200

{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files/ee4733cd-b1a7-4813-87e2-00d582c28a29?api-version=3.2",
      "name": "mywavefile1.wav.json",
      "kind": "Transcription",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/mywavefile1.wav.json?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=e05d8d56-9675-448b-820c-4318ae64c8d5"
      },
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z"
    },
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files/28bc946b-c251-4a86-84f6-ea0f0a2373ef?api-version=3.2",
      "name": "mywavefile2.wav.json",
      "kind": "Transcription",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/mywavefile2.wav.json?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=e05d8d56-9675-448b-820c-4318ae64c8d5"
      },
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z"
    }
  ],
  "@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?skip=2&top=2&api-version=2024-11-15"
}

Get all transcription files the name of which starts with the specified string

Ukázkový požadavek

HTTP

GET {endpoint}/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?sasLifetimeMinutes=360&skip=0&top=10&filter=name%20eq%20'mywavefile1.wav.json'&api-version=2024-11-15

Ukázková odpověď

Stavový kód:: 200

{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files/ee4733cd-b1a7-4813-87e2-00d582c28a29?api-version=3.2",
      "name": "mywavefile1.wav.json",
      "kind": "Transcription",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/mywavefile1.wav.json?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=e05d8d56-9675-448b-820c-4318ae64c8d5"
      },
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z"
    }
  ]
}

Definice

Name	Description
DetailedErrorCode	DetailedErrorCode
Error	Chyba
ErrorCode	Kód chyby
File	Soubor
FileKind	FileKind
FileLinks	FileLinks
FileProperties	FileProperties
InnerError	Vnitřní chyba
PaginatedFiles	PaginatedFiles

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

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.

File

Soubor

Name	Typ	Description
createdDateTime	string	Čas vytvoření tohoto souboru. Časové razítko je kódováno jako formát data a času ISO 8601 (viz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
kind	FileKind	FileKind Typ dat
links	FileLinks	FileLinks
name	string	Název tohoto souboru.
properties	FileProperties	FileProperties
self	string	Umístění této entity.

FileKind

Name	Typ	Description
AcousticDataArchive	string	Typ dat je archiv akustických dat.
AcousticDataTranscriptionV2	string	Typ dat je přepis akustických dat v2.
Audio	string	Typ dat je zvuk.
DatasetReport	string	Typ dat je sestava datové sady.
EvaluationDetails	string	Typ dat je podrobnosti vyhodnocení.
LanguageData	string	Typ dat je jazyková data.
ModelReport	string	Typ dat je sestava modelu.
OutputFormattingData	string	Typ dat je výstupní formát vstupního souboru.
PronunciationData	string	Typ dat je výslovnost dat.
Transcription	string	Typ dat je přepis.
TranscriptionReport	string	Typ dat je sestava přepisu.

FileLinks

Name	Typ	Description
contentUrl	string	Adresa URL pro načtení obsahu tohoto souboru.

FileProperties

Name	Typ	Default value	Description
durationMilliseconds	integer	0	Celková doba trvání souboru v milisekundách v případě, že jde o zvukový soubor.
size	integer		Velikost dat vbajch

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

PaginatedFiles

Name	Typ	Description
@nextLink	string	Odkaz na další sadu stránkovaných výsledků, pokud je k dispozici více entit; jinak null.
values	File[]	Seznam entit omezený buď předanými parametry dotazu "skip" a "top" nebo jejich výchozími hodnotami. Při paralelním procházení seznamu pomocí stránkování a odstranění entit se ve výsledcích přeskočí některé entity. Po načtení kompletního seznamu doporučujeme sestavit seznam na klientovi a odstranit ho.

Name

Typ

Description

@nextLink

string

Odkaz na další sadu stránkovaných výsledků, pokud je k dispozici více entit; jinak null.

values

File[]

Seznam entit omezený buď předanými parametry dotazu "skip" a "top" nebo jejich výchozími hodnotami.

Při paralelním procházení seznamu pomocí stránkování a odstranění entit se ve výsledcích přeskočí některé entity. Po načtení kompletního seznamu doporučujeme sestavit seznam na klientovi a odstranit ho.

Sdílet prostřednictvím

Transcriptions - List Files

Parametry identifikátoru URI

Hlavička požadavku

Odpovědi

Zabezpečení

Ocp-Apim-Subscription-Key

Příklady

Get all files

Ukázkový požadavek

Ukázková odpověď

Get all transcription files the name of which starts with the specified string

Ukázkový požadavek

Ukázková odpověď

Definice

DetailedErrorCode

Error

ErrorCode

File

FileKind

FileLinks

FileProperties

InnerError

PaginatedFiles

Další materiály