Sdílet prostřednictvím


Transcriptions - Update

Aktualizace proměnlivé podrobnosti přepisu identifikované jeho ID.

PATCH {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.

Text požadavku

Media Types: "application/json", "application/merge-patch+json"

Name Typ Description
customProperties

object

Vlastní vlastnosti této entity. Maximální povolená délka klíče je 64 znaků, maximální délka povolené hodnoty je 256 znaků a počet povolených položek je 10.

description

string

Popis objektu.

displayName

string

Název objektu.

project

EntityReference

EntityReference

Odpovědi

Name Typ Description
200 OK

Transcription

OK

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

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 do adresy URL služby STS: ?scope=speechservicesmanagement.

Typ: apiKey
V: header

Příklady

Update a transcription

Ukázkový požadavek

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

{
  "displayName": "Updated transcription name",
  "description": "Updated transcription description",
  "customProperties": {
    "key": "value"
  }
}

Ukázková odpověď

{
  "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 přepisu

TranscriptionProperties

Vlastnosti přepisu

TranscriptionUpdate

PřepisAktualizace

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í neúspěšného modelu

EmptyRequest

string

Prázdný požadavek.

EndpointCannotBeDefault

string

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

EndpointNotUpdatable

string

Koncový bod není možné aktualizovat.

EndpointWithoutLogging

string

Koncový bod bez protokolování.

ExceededNumberOfRecordingsUris

string

Překročili jsme počet nahrávek uris.

FailedDataset

string

Datová sada se nezdařila.

Forbidden

string

Zakázáno.

InUseViolation

string

Porušením 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ý koncový čas 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ý předpoklad.

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

Neplatný čas do života.

InvalidTopForLogs

string

Neplatná horní část pro protokoly.

InvalidTranscription

string

Neplatný přepis.

InvalidWebHookEventKind

string

Neplatný druh události web hooku

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

Ne utf8 s bom.

OnlyOneOfUrlsOrContainerOrDataset

string

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

ProjectGenderMismatch

string

Neshoda mezi pohlavími 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říd.

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
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 roven vlastnosti maxSpeakers.

EntityError

Chyba entity

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

ErrorCode
Kódy chyb vysoké úrovně.

details

Error[]

Další podrobnosti podpory týkající se chyby nebo očekávaných zásad

innerError

InnerError

Vnitřní chyba
Nový formát vnitřní chyby, 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. Například v případě neplatného dokumentu by to byly "dokumenty" nebo "ID dokumentu".

ErrorCode

ErrorCode

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 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 nezpracovaný kód chyby 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ší podrobnosti podpory týkající se chyby nebo očekávaných zásad

innerError

InnerError

Vnitřní chyba
Nový formát vnitřní chyby, 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. Například v případě neplatného dokumentu by to byly "dokumenty" nebo "ID dokumentu".

LanguageIdentificationMode

LanguageIdentificationMode

Name Typ Description
Continuous

string

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

Single

string

Identifikace jednoho jazyka.

LanguageIdentificationProperties

LanguageIdentificationProperties

Name Typ Default value Description
candidateLocales

string[]

Kandidátské národní prostředí pro identifikaci jazyka (pří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ý 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í 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ýraz * s výjimkou prvního písmena, například f***

None

string

Zakažte filtrování vulgárních výrazů.

Removed

string

Odeberte 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 ještě nebyla spuštěna.

Running

string

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

Succeeded

string

Dlouhotrvající operace se úspěšně dokončila.

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 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, kdy byl objekt vytvořen. Č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í délka povolené 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ó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

Odkazy přepisu

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 zjistit žá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

Odkazy přepisu

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

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

Při použití cílového kontejneru v kombinaci s objektem 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 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 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í, zda je požadována 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 poskytne diarizaci pro konfigurovatelný rozsah reproduktorů. Pokud je toto pole nastaveno na hodnotu true a vylepšený systém diarizace není povolený (nezadá se 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 odebere se v další hlavní verzi rozhraní API. 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ář zobrazení. Výchozí hodnota je false.

duration

string

Doba trvání přepisu. Doba trvání je zakó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 mají 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 dosáhne časového limitu po dokončení (ú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 zakódovaná jako doba trvání ISO 8601 ("PnYnMnDTnHnMnS", viz https://en.wikipedia.org/wiki/ISO_8601#Durations).

wordLevelTimestampsEnabled

boolean

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

TranscriptionUpdate

PřepisAktualizace

Name Typ Description
customProperties

object

Vlastní vlastnosti této entity. Maximální povolená délka klíče je 64 znaků, maximální délka povolené hodnoty je 256 znaků a počet povolených položek je 10.

description

string

Popis objektu.

displayName

string

Název objektu.

project

EntityReference

EntityReference