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 |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK Hlavičky Retry-After: integer |
|
Other Status Codes |
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 |
---|---|
Detailed |
Podrobný kód chyby |
Diarization |
DiarizationProperties |
Diarization |
DiarizationSpeakersVlastnosti |
Entity |
Chyba entity |
Entity |
EntityReference |
Error |
Chyba |
Error |
ErrorCode |
Inner |
Vnitřní chyba |
Language |
LanguageIdentificationMode |
Language |
LanguageIdentificationProperties |
Profanity |
Vulgární výrazyFilterMode |
Punctuation |
Interpunkční znaméně |
Status |
Stav |
Transcription |
Transkripce |
Transcription |
Odkazy přepisu |
Transcription |
Vlastnosti přepisu |
Transcription |
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 |
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 |
|
details |
Error[] |
Další podrobnosti podpory týkající se chyby nebo očekávaných zásad |
innerError |
Vnitřní chyba |
|
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 |
Podrobný kód chyby |
|
details |
object |
Další podrobnosti podpory týkající se chyby nebo očekávaných zásad |
innerError |
Vnitřní chyba |
|
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 | Continuous |
LanguageIdentificationMode |
|
speechModelMapping |
<string,
Entity |
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 |
|
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 |
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 |
|
project |
EntityReference |
|
properties |
Vlastnosti přepisu |
|
self |
string |
Umístění této entity. |
status |
Stav |
TranscriptionLinks
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ámkyPři použití cílového kontejneru v kombinaci s objektem |
diarization |
DiarizationProperties |
|
diarizationEnabled |
boolean |
Hodnota označující, zda je požadována diarizace (identifikace mluvčího). Výchozí hodnota je Systém základní diarizace je zastaralý a odebere se v další hlavní verzi rozhraní API.
Toto |
displayFormWordLevelTimestampsEnabled |
boolean |
Hodnota označující, zda jsou požadována časová razítka na úrovni slov pro formulář zobrazení. Výchozí hodnota je |
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). |
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 |
Chyba entity |
|
languageIdentification |
LanguageIdentificationProperties |
|
profanityFilterMode |
Vulgární výrazyFilterMode |
|
punctuationMode |
Interpunkční znaméně |
|
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 |
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 |