Transcriptions - Submit

Odešle novou úlohu přepisu.

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2025-10-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).

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 klíč účtu služeb Cognitive Services.

Text požadavku

Name Vyžadováno Typ Description
displayName True

string

minLength: 1

Zobrazovaný název objektu.

locale True

string

minLength: 1

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.

properties True

TranscriptionProperties

PřepisProperties

contentContainerUrl

string (uri)

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 10000 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 vrácena v odpovědi.

contentUrls

string[] (uri)

Seznam adres URL obsahu pro získání zvukových souborů k přepisu. Je povoleno až 1000 adres URL. Tato vlastnost nebude vrácena v odpovědi.

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.

model

EntityReference

EntityReference

project

EntityReference

EntityReference

Odpovědi

Name Typ Description
201 Created

Transcription

Odpověď obsahuje informace o entitě jako datové části a jejím umístění jako hlavičku.

Hlavičky

Location: string

Other Status Codes

Error

Došlo k chybě.

Zabezpečení

Ocp-Apim-Subscription-Key

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

Typ: apiKey
V: header

Příklady

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

Ukázkový požadavek

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

Ukázková odpověď

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

Ukázkový požadavek

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

Ukázková odpověď

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

Ukázkový požadavek

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

Ukázková odpověď

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

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
DetailedErrorCode

DetailedErrorCode

DiarizationProperties

DiarizationProperties

EntityError

Chyba entity

EntityReference

EntityReference

Error

Error

ErrorCode

ErrorCode

InnerError

Vnitřní chyba

LanguageIdentificationMode

Režim identifikace jazyka

LanguageIdentificationProperties

LanguageIdentificationProperties

ProfanityFilterMode

Vulgární výrazFilterMode

PunctuationMode

Interpunkční znaméčko

Status

Stav

Transcription

Přepis

TranscriptionLinks

Odkazy na přepis

TranscriptionProperties

PřepisProperties

DetailedErrorCode

DetailedErrorCode

Hodnota Description
InvalidParameterValue

Neplatná hodnota parametru.

InvalidRequestBodyFormat

Neplatný formát textu požadavku.

EmptyRequest

Prázdný požadavek.

MissingInputRecords

Chybějící vstupní záznamy.

InvalidDocument

Neplatný dokument.

ModelVersionIncorrect

Verze modelu je nesprávná.

InvalidDocumentBatch

Neplatná dávka dokumentu.

UnsupportedLanguageCode

Nepodporovaný kód jazyka.

DataImportFailed

Import dat se nezdařil.

InUseViolation

Porušení pravidel používání.

InvalidLocale

Neplatné národní prostředí.

InvalidBaseModel

Neplatný základní model.

InvalidAdaptationMapping

Neplatné mapování adaptace.

InvalidDataset

Neplatná datová sada.

InvalidTest

Neplatný test.

FailedDataset

Neúspěšná datová sada.

InvalidModel

Neplatný model.

InvalidTranscription

Neplatný přepis.

InvalidPayload

Neplatná datová část.

InvalidParameter

Neplatný parametr.

EndpointWithoutLogging

Koncový bod bez protokolování.

InvalidPermissions

Neplatná oprávnění.

InvalidPrerequisite

Neplatný předpoklad.

InvalidProductId

Neplatné ID produktu.

InvalidSubscription

Neplatné předplatné.

InvalidProject

Neplatný projekt.

InvalidProjectKind

Neplatný druh projektu.

InvalidRecordingsUri

Neplatné identifikátory URI nahrávek.

OnlyOneOfUrlsOrContainerOrDataset

Pouze jedna z adres URL nebo kontejneru nebo datové sady.

ExceededNumberOfRecordingsUris

Byl překročen počet nahrávek URI.

InvalidChannels

Neplatné kanály.

ModelMismatch

Neshoda modelu.

ProjectGenderMismatch

Promítat nesoulad pohlaví.

ModelDeprecated

Model je zastaralý.

ModelExists

Model existuje.

ModelNotDeployable

Model nelze nasadit.

EndpointNotUpdatable

Koncový bod nelze aktualizovat.

SingleDefaultEndpoint

Jeden výchozí koncový bod.

EndpointCannotBeDefault

Koncový bod nemůže být výchozí.

InvalidModelUri

Neplatný identifikátor URI modelu.

SubscriptionNotFound

Předplatné nebylo nalezeno.

QuotaViolation

Porušení kvóty.

UnsupportedDelta

Nepodporovaná delta.

UnsupportedFilter

Nepodporovaný filtr.

UnsupportedPagination

Nepodporované stránkování.

UnsupportedDynamicConfiguration

Nepodporovaná dynamická konfigurace.

UnsupportedOrderBy

Nepodporovaná objednávka.

NoUtf8WithBom

Žádné utf8 s bom.

ModelDeploymentNotCompleteState

Stav nasazení modelu není dokončen.

SkuLimitsExist

Existují limity SKU.

DeployingFailedModel

Nasazení neúspěšného modelu.

UnsupportedTimeRange

Nepodporovaný časový rozsah.

InvalidLogDate

Neplatné datum protokolu.

InvalidLogId

Neplatné ID protokolu.

InvalidLogStartTime

Neplatný čas spuštění protokolu.

InvalidLogEndTime

Neplatný čas ukončení protokolu.

InvalidTopForLogs

Neplatný vršek pro polena.

InvalidSkipTokenForLogs

Neplatný token pro přeskočení protokolů.

DeleteNotAllowed

Mazání není povoleno.

Forbidden

Zakázaný.

DeployNotAllowed

Nasazení není povoleno.

UnexpectedError

Neočekávaná chyba.

InvalidCollection

Neplatné kolekce.

InvalidCallbackUri

Neplatný identifikátor URI zpětného volání.

InvalidSasValidityDuration

Neplatná doba platnosti SAS.

InaccessibleCustomerStorage

Nepřístupné úložiště pro zákazníky.

UnsupportedClassBasedAdaptation

Nepodporovaná adaptace založená na třídách.

InvalidWebHookEventKind

Neplatný druh události webhooku.

InvalidTimeToLive

Neplatná doba života.

InvalidSourceAzureResourceId

Neplatné ID zdrojového prostředku Azure.

ModelCopyAuthorizationExpired

Platnost modelu ModelCopyAuthorization vypršela.

EndpointLoggingNotSupported

Protokolování koncového bodu není podporováno.

NoLanguageIdentified

Identifikace jazyka nerozpoznala žádný jazyk.

MultipleLanguagesIdentified

Identifikace jazyka rozpoznala více jazyků. Žádný dominantní jazyk nemohl být určen.

InvalidAudioFormat

Formát vstupního zvuku není podporován.

BadChannelConfiguration

Dochází k nesouladu mezi zvukovými kanály v datech, v konfiguraci nebo v požadavcích aplikace.

InvalidChannelSpecification

Výběr kanálů v požadavku na přepis není podporován (např. nebyla vybrána hodnota 0 ani 1).

AudioLengthLimitExceeded

Zvukový soubor je delší než maximální povolená doba trvání.

EmptyAudioFile

Zvukový soubor je prázdný.

DiarizationProperties

DiarizationProperties

Name Typ Description
enabled

boolean

Hodnota označující, zda je povolena diarizace reproduktoru.

maxSpeakers

integer (int32)

minimum: 2
maximum: 35

Tip na maximální počet mluvčích pro diarizaci. Musí být větší než 1 a menší než 36.

EntityError

Chyba entity

Name Typ Description
code

string

Kód této chyby.

message

string

Zpráva o této chybě.

EntityReference

EntityReference

Name Typ Description
self

string (uri)

Umístění odkazované entity.

Error

Error

Name Typ Description
code

ErrorCode

ErrorCode
Chybové kódy 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ý je v souladu s pokyny pro 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, zpráva a volitelné vlastnosti target, details(pár klíč-hodnota), inner error (může být vnořeno).

message

string

Chybová zpráva vysoké úrovně.

target

string

Zdroj chyby. Například by to bylo "dokumenty" nebo "ID dokumentu" v případě neplatného dokumentu.

ErrorCode

ErrorCode

Hodnota Description
InvalidRequest

Představuje neplatný kód chyby požadavku.

InvalidArgument

Představuje kód chyby neplatného argumentu.

InternalServerError

Představuje kód chyby interní chyby serveru.

ServiceUnavailable

Představující kód chyby nedostupné služby.

NotFound

Představuje kód chyby nenalezeno.

PipelineError

Představuje kód chyby chyby kanálu.

Conflict

Představuje kód chyby konfliktu.

InternalCommunicationFailed

Představující interní komunikaci selhal chybový kód.

Forbidden

Představuje zakázaný kód chyby.

NotAllowed

Představuje kód chyby not allowed.

Unauthorized

Představuje neoprávněný kód chyby.

UnsupportedMediaType

Představuje kód chyby nepodporovaného typu média.

TooManyRequests

Představující kód chyby příliš mnoho požadavků.

UnprocessableEntity

Představuje kód chyby nezpracovatelné entity.

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ý je v souladu s pokyny pro 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, zpráva a volitelné vlastnosti target, details(pár klíč-hodnota), inner error (může být vnořeno).

message

string

Chybová zpráva vysoké úrovně.

target

string

Zdroj chyby. Například by to bylo "dokumenty" nebo "ID dokumentu" v případě neplatného dokumentu.

LanguageIdentificationMode

Režim identifikace jazyka

Hodnota Description
Continuous

Průběžná identifikace jazyka (výchozí).

Single

Identifikace v jednom jazyce. 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

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"]). V nepřetržitém režimu jsou podporovány 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 je maximální počet kandidátských národních prostředí neomezený.

mode

LanguageIdentificationMode

Continuous

Režim identifikace jazyka
Režim používaný pro 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í zadán žádný model, použije se výchozí základní model. Klíče musí být locales obsažené v kandidátských locales, hodnoty jsou entity pro modely příslušných locales.

ProfanityFilterMode

Vulgární výrazFilterMode

Hodnota Description
None

Vypněte filtrování vulgárních výrazů.

Removed

Odstraňte vulgární výrazy.

Tags

Přidání XML tagů "vulgárních výrazů" / Vulgárních výrazů<>

Masked

Maskujte vulgární výrazy pomocí * kromě prvního písmene, např. f***

PunctuationMode

Interpunkční znaméčko

Hodnota Description
None

Žádná interpunkce.

Dictated

Pouze diktovaná interpunkční znaménka, tj. explicitní interpunkční znaménka.

Automatic

Automatická interpunkce.

DictatedAndAutomatic

Nadiktovaná interpunkční znaménka nebo automatická interpunkce.

Status

Stav

Hodnota Description
NotStarted

Dlouhotrvající operace ještě nebyla zahájena.

Running

Dlouhotrvající operace se právě zpracovává.

Succeeded

Dlouhotrvající operace byla úspěšně dokončena.

Failed

Dlouhotrvající operace se nezdařila.

Transcription

Přepis

Name Typ Description
contentContainerUrl

string (uri)

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 10000 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 vrácena v odpovědi.

contentUrls

string[] (uri)

Seznam adres URL obsahu pro získání zvukových souborů k přepisu. Je povoleno až 1000 adres URL. Tato vlastnost nebude vrácena v odpovědi.

createdDateTime

string (date-time)

Časové razítko, kdy byl objekt vytvořen. Časové razítko je kódováno jako formát data a času ISO 8601 ("YYYY-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

minLength: 1

Zobrazovaný název objektu.

lastActionDateTime

string (date-time)

Časové razítko při zadání aktuálního stavu. Časové razítko je kódováno jako formát data a času ISO 8601 ("YYYY-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

minLength: 1

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

project

EntityReference

EntityReference

properties

TranscriptionProperties

PřepisProperties

self

string (uri)

Umístění této entity.

status

Status

Stav
Popište aktuální stav rozhraní API.

Odkazy na přepis

Name Typ Description
files

string (uri)

Umístění pro získání všech souborů této entity. Další podrobnosti naleznete v operaci "Transcriptions_ListFiles".

TranscriptionProperties

PřepisProperties

Name Typ Default value Description
channels

integer[] (int32)

Sbírka požadovaných čísel kanálů. Ve výchozím případě jsou brány v úvahu kanály 0 a 1.

destinationContainerUrl

string (uri)

Požadovaný cílový kontejner.

Poznámky

Pokud je cílový kontejner použit v kombinaci s timeToLive, metadata přepisu budou odstraněna normálně, ale data uložená v cílovém kontejneru, včetně výsledků přepisu, zůstanou nedotčena, protože pro tento kontejner nejsou vyžadována žádná oprávnění k odstranění.

Pokud chcete podporovat automatické čištění, nakonfigurujte životnost objektů blob v kontejneru nebo 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

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 (int64)

0

Doba trvání přepisu v milisekundách. Doby trvání delší než 2^53-1 nejsou podporovány, aby byla zajištěna kompatibilita s celými čísly JavaScriptu.

error

EntityError

Chyba entity

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 (int32)

Jak dlouho se přepis bude uchovávat v systému po jeho dokončení. Jakmile přepis po dokončení (úspěšný nebo neúspěšný) dosáhne doby životnosti, bude automaticky smazán.

Poznámka: Při použití BYOS (Přineste si vlastní úložiště) se odstraní také výsledné soubory v účtu úložiště vlastněném zákazníkem. Pomocí metody destinationContainerUrl určete samostatný kontejner pro výsledné soubory, které nebudou po vypršení platnosti funkce timeToLive odstraněny, nebo načtěte výsledné soubory prostřednictvím rozhraní API a podle potřeby je uložte.

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, pokud jsou data spotřebovávána přímo.

wordLevelTimestampsEnabled

boolean

Hodnota označující, zda jsou požadovány časová razítka na úrovni slova. Výchozí hodnota je false.