Sdílet prostřednictvím


Transcriptions - Submit

Odešle novou úlohu přepisu.

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

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.

Text požadavku

Name Vyžadováno Typ Description
displayName True

string

Zobrazovaný název objektu.

locale True

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.

properties True

TranscriptionProperties

PřepisProperties

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.

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.

model

EntityReference

EntityReference

Odpovědi

Name Typ Description
201 Created

Transcription

Odpověď obsahuje informace o entitě jako datové části a jeho umístění jako záhlaví.

Hlavičky

Location: string

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

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=2024-11-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=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"
}

Create a transcription from blob container

Ukázkový požadavek

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2024-11-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=2024-11-15
{
  "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"
}

Create a transcription with language identification

Ukázkový požadavek

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2024-11-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=2024-11-15"
        }
      },
      "mode": "Single"
    }
  }
}

Ukázková odpověď

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683?api-version=2024-11-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=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,
    "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=2024-11-15"
        }
      },
      "mode": "Single"
    },
    "durationMilliseconds": 42000
  },
  "status": "Succeeded"
}

Create a transcription with multispeaker diarization

Ukázkový požadavek

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2024-11-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=2024-11-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=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,
    "diarization": {
      "enabled": true,
      "maxSpeakers": 5
    },
    "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

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

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

EntityError

Name Typ Description
code

string

Kód této chyby.

message

string

Zpráva pro tuto chybu.

EntityReference

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

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

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.

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 timeToLivese 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 destinationContainerUrlpouž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.