Transcriptions - Update

Referens

Tjänst:: Azure AI Services

API-version:: 3.2

Uppdaterar den föränderliga informationen om transkriptionen som identifieras med dess ID.

PATCH {endpoint}/speechtotext/v3.2/transcriptions/{id}

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://westus.api.cognitive.microsoft.com).
id	path	True	string uuid	Identifieraren för transkriptionen.

Begärandetext

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

Name	Typ	Description
customProperties	object	De anpassade egenskaperna för den här entiteten. Den maximala tillåtna nyckellängden är 64 tecken, den maximala tillåtna värdelängden är 256 tecken och antalet tillåtna poster är 10.
description	string	Beskrivningen av objektet.
displayName	string	Namnet på objektet.
project	EntityReference	EntityReference

Svar

Name	Typ	Description
200 OK	Transcription	OK Sidhuvuden Retry-After: integer
Other Status Codes	Error	Ett fel inträffade.

Name

Typ

Description

200 OK

Transcription

Sidhuvuden

Retry-After: integer

Other Status Codes

Error

Ett fel inträffade.

Säkerhet

Ocp-Apim-Subscription-Key

Ange din cognitive services-kontonyckel här.

Typ: apiKey
I: header

Authorization

Ange en åtkomsttoken från JWT som returneras av STS i den här regionen. Se till att lägga till hanteringsomfånget i token genom att lägga till följande frågesträng i STS-URL:en: ?scope=speechservicesmanagement

Typ: apiKey
I: header

Exempel

Update a transcription

Exempelbegäran

HTTP

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

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

Exempelsvar

Statuskod:: 200

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.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"
  }
}

Definitioner

Name	Description
DetailedErrorCode	DetailedErrorCode
DiarizationProperties	DiarizationProperties
DiarizationSpeakersProperties	DiarizationSpeakersEgenskaper
EntityError	EntityError
EntityReference	EntityReference
Error	Fel
ErrorCode	Felkod
InnerError	InnerError
LanguageIdentificationMode	LanguageIdentificationMode
LanguageIdentificationProperties	LanguageIdentificationProperties
ProfanityFilterMode	ProfanityFilterMode
PunctuationMode	SkiljeteckenMode
Status	Status
Transcription	Transkription
TranscriptionLinks	TranskriptionLänkar
TranscriptionProperties	TranskriptionEgenskaper
TranscriptionUpdate	TranscriptionUpdate

DetailedErrorCode

Name	Typ	Description
DataImportFailed	string	Dataimporten misslyckades.
DeleteNotAllowed	string	Ta bort tillåts inte.
DeployNotAllowed	string	Distribution tillåts inte.
DeployingFailedModel	string	Det gick inte att distribuera modellen.
EmptyRequest	string	Tom begäran.
EndpointCannotBeDefault	string	Slutpunkten kan inte vara standard.
EndpointNotUpdatable	string	Slutpunkten kan inte uppdateras.
EndpointWithoutLogging	string	Slutpunkt utan loggning.
ExceededNumberOfRecordingsUris	string	Överskred antalet inspelningar.
FailedDataset	string	Datauppsättningen misslyckades.
Forbidden	string	Förbjudet.
InUseViolation	string	Vid användningsöverträdelse.
InaccessibleCustomerStorage	string	Otillgänglig kundlagring.
InvalidAdaptationMapping	string	Ogiltig anpassningsmappning.
InvalidBaseModel	string	Ogiltig basmodell.
InvalidCallbackUri	string	Ogiltig återanrops-uri.
InvalidChannels	string	Ogiltiga kanaler.
InvalidCollection	string	Ogiltig samling.
InvalidDataset	string	Ogiltig datauppsättning.
InvalidDocument	string	Ogiltigt dokument.
InvalidDocumentBatch	string	Ogiltig dokumentbatch.
InvalidLocale	string	Ogiltigt språk.
InvalidLogDate	string	Ogiltigt loggdatum.
InvalidLogEndTime	string	Ogiltig sluttid för logg.
InvalidLogId	string	Ogiltigt logg-ID.
InvalidLogStartTime	string	Ogiltig starttid för logg.
InvalidModel	string	Ogiltig modell.
InvalidModelUri	string	Ogiltig modell-URI.
InvalidParameter	string	Ogiltig parameter.
InvalidParameterValue	string	Ogiltigt parametervärde.
InvalidPayload	string	Ogiltig nyttolast.
InvalidPermissions	string	Ogiltiga behörigheter.
InvalidPrerequisite	string	Ogiltigt krav.
InvalidProductId	string	Ogiltigt produkt-ID.
InvalidProject	string	Ogiltigt projekt.
InvalidProjectKind	string	Ogiltig projekttyp.
InvalidRecordingsUri	string	Ogiltig inspelnings-URI.
InvalidRequestBodyFormat	string	Ogiltigt format för begärandetext.
InvalidSasValidityDuration	string	Ogiltig varaktighet för sas-giltighet.
InvalidSkipTokenForLogs	string	Ogiltig hopptoken för loggar.
InvalidSourceAzureResourceId	string	Ogiltigt käll-Azure-resurs-ID.
InvalidSubscription	string	Ogiltig prenumeration.
InvalidTest	string	Ogiltigt test.
InvalidTimeToLive	string	Ogiltig tid att leva.
InvalidTopForLogs	string	Ogiltig topp för loggar.
InvalidTranscription	string	Ogiltig transkription.
InvalidWebHookEventKind	string	Ogiltig webbhookhändelsetyp.
MissingInputRecords	string	Indataposter saknas.
ModelCopyAuthorizationExpired	string	ModelCopyAuthorization har upphört att gälla.
ModelDeploymentNotCompleteState	string	Modelldistributionen är inte fullständigt.
ModelDeprecated	string	Modellen är inaktuell.
ModelExists	string	Modellen finns.
ModelMismatch	string	Modellmatchningsfel.
ModelNotDeployable	string	Modellen kan inte distribueras.
ModelVersionIncorrect	string	Felaktig modellversion.
NoUtf8WithBom	string	Ingen utf8 med bom.
OnlyOneOfUrlsOrContainerOrDataset	string	Endast en av URL:erna, containern eller datauppsättningen.
ProjectGenderMismatch	string	Projektets könsmatchningsfel.
QuotaViolation	string	Kvotöverträdelse.
SingleDefaultEndpoint	string	Enskild standardslutpunkt.
SkuLimitsExist	string	Det finns SKU-gränser.
SubscriptionNotFound	string	Det går inte att hitta prenumerationen.
UnexpectedError	string	Oväntat fel.
UnsupportedClassBasedAdaptation	string	Klassbaserad anpassning stöds inte.
UnsupportedDelta	string	Delta stöds inte.
UnsupportedDynamicConfiguration	string	Dynamisk konfiguration som inte stöds.
UnsupportedFilter	string	Filter som inte stöds.
UnsupportedLanguageCode	string	Språkkod som inte stöds.
UnsupportedOrderBy	string	Beställningen stöds inte av.
UnsupportedPagination	string	Sidnumrering stöds inte.
UnsupportedTimeRange	string	Tidsintervallet stöds inte.

DiarizationProperties

Name	Typ	Description
speakers	DiarizationSpeakersProperties	DiarizationSpeakersEgenskaper

DiarizationSpeakersProperties

DiarizationSpeakersEgenskaper

Name	Typ	Description
maxCount	integer	Det maximala antalet talare för diarisering. Måste vara mindre än 36 och större än eller lika med egenskapen minSpeakers.
minCount	integer	Ett tips för det minsta antalet talare för diarisering. Måste vara mindre än eller lika med egenskapen maxSpeakers.

EntityError

Name	Typ	Description
code	string	Koden för det här felet.
message	string	Meddelandet för det här felet.

EntityReference

Name	Typ	Description
self	string	Platsen för den refererade entiteten.

Error

Fel

Name	Typ	Description
code	ErrorCode	Felkod Felkoder på hög nivå.
details	Error[]	Ytterligare stödjande information om fel- och/eller förväntade principer.
innerError	InnerError	InnerError Nytt format för inre fel som överensstämmer med Cognitive Services API Guidelines som finns på https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Detta innehåller de obligatoriska egenskaperna ErrorCode, message och optional properties target, details(key value pair), inner error(this can be nested).
message	string	Felmeddelande på hög nivå.
target	string	Källan till felet. Det skulle till exempel vara "dokument" eller "dokument-ID" om dokumentet är ogiltigt.

ErrorCode

Felkod

Name	Typ	Description
Conflict	string	Representerar konfliktfelkoden.
Forbidden	string	Representerar den förbjudna felkoden.
InternalCommunicationFailed	string	Representerar felkoden för den interna kommunikationen misslyckades.
InternalServerError	string	Representerar den interna felkoden för servern.
InvalidArgument	string	Representerar den ogiltiga argumentfelkoden.
InvalidRequest	string	Representerar den ogiltiga felkoden för begäran.
NotAllowed	string	Representerar den felkod som inte tillåts.
NotFound	string	Representerar felkoden hittades inte.
PipelineError	string	Representerar felkoden för pipelinefel.
ServiceUnavailable	string	Representerar felkoden för tjänsten som inte är tillgänglig.
TooManyRequests	string	Representerar felkoden för för många begäranden.
Unauthorized	string	Representerar den obehöriga felkoden.
UnprocessableEntity	string	Representerar felkoden för entiteten som inte kan bearbetas.
UnsupportedMediaType	string	Representerar felkoden för medietypen som inte stöds.

InnerError

Name	Typ	Description
code	DetailedErrorCode	DetailedErrorCode Detaljerad felkodsuppräkning.
details	object	Ytterligare stödjande information om fel- och/eller förväntade principer.
innerError	InnerError	InnerError Nytt format för inre fel som överensstämmer med Cognitive Services API Guidelines som finns på https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Detta innehåller de obligatoriska egenskaperna ErrorCode, message och optional properties target, details(key value pair), inner error(this can be nested).
message	string	Felmeddelande på hög nivå.
target	string	Källan till felet. Det skulle till exempel vara "dokument" eller "dokument-ID" om dokumentet är ogiltigt.

LanguageIdentificationMode

Name	Typ	Description
Continuous	string	Kontinuerlig språkidentifiering (standard).
Single	string	Enkel språkidentifiering.

LanguageIdentificationProperties

Name	Typ	Standardvärde	Description
candidateLocales	string[]		Kandidatspråk för språkidentifiering (exempel ["en-US", "de-DE", "es-ES"]). Minst 2 och högst 10 kandidatspråk, inklusive huvudspråket för transkriptionen, stöds för kontinuerligt läge. För enkel språkidentifiering är det maximala antalet kandidatspråk obundna.
mode	LanguageIdentificationMode	Continuous	LanguageIdentificationMode Det läge som används för språkidentifiering.
speechModelMapping	<string, EntityReference>		En valfri mappning av nationella inställningar till talmodellentiteter. Om ingen modell anges för nationella inställningar används standardbasmodellen. Nycklar måste vara nationella inställningar som finns i kandidatspråken, värden är entiteter för modeller av respektive språk.

ProfanityFilterMode

Name	Typ	Description
Masked	string	Maskera svordomarna med * förutom den första bokstaven, t.ex. f***
None	string	Inaktivera filtrering av olämpligt språk.
Removed	string	Ta bort svordomar.
Tags	string	Lägg till XML-taggar</svordomar för "svordomar">

PunctuationMode

SkiljeteckenMode

Name	Typ	Description
Automatic	string	Automatisk skiljetecken.
Dictated	string	Endast dikterade skiljetecken, d.v.s. explicit skiljetecken.
DictatedAndAutomatic	string	Dikterade skiljetecken eller automatiska skiljetecken.
None	string	Ingen skiljetecken.

Status

Name	Typ	Description
Failed	string	Den långvariga åtgärden misslyckades.
NotStarted	string	Den långvariga åtgärden har ännu inte startats.
Running	string	Den tidskrävande åtgärden bearbetas för närvarande.
Succeeded	string	Den långvariga åtgärden har slutförts.

Transcription

Transkription

Name	Typ	Description
contentContainerUrl	string	En URL för en Azure-blobcontainer som innehåller ljudfilerna. En container får ha en maximal storlek på 5 GB och ett maximalt antal 1 0000 blobar. Den maximala storleken för en blob är 2,5 GB. Container-SAS ska innehålla behörigheterna "r" (läsa) och "l" (lista). Den här egenskapen returneras inte i ett svar.
contentUrls	string[]	En lista över innehålls-URL:ar för att hämta ljudfiler som ska transkriberas. Upp till 1 000 URL:ar tillåts. Den här egenskapen returneras inte i ett svar.
createdDateTime	string	Tidsstämpeln när objektet skapades. Tidsstämpeln kodas som datum- och tidsformatet ISO 8601 ("ÅÅÅÅ-MM-DDThh:mm:ssZ", se https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties	object	De anpassade egenskaperna för den här entiteten. Den maximala tillåtna nyckellängden är 64 tecken, den maximala tillåtna värdelängden är 256 tecken och antalet tillåtna poster är 10.
dataset	EntityReference	EntityReference
description	string	Beskrivningen av objektet.
displayName	string	Objektets visningsnamn.
lastActionDateTime	string	Tidsstämpeln när den aktuella statusen angavs. Tidsstämpeln kodas som datum- och tidsformatet ISO 8601 ("ÅÅÅÅ-MM-DDThh:mm:ssZ", se https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	TranscriptionLinks	TranskriptionLänkar
locale	string	Nationella inställningar för inneslutna data. Om språkidentifiering används används det här språket för att transkribera tal som inget språk kunde identifieras för.
model	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	TranscriptionProperties	TranskriptionEgenskaper
self	string	Platsen för den här entiteten.
status	Status	Status Beskriv API:ets aktuella tillstånd.

TranscriptionLinks

TranskriptionLänkar

Name	Typ	Description
files	string	Platsen för att hämta alla filer för den här entiteten. Mer information finns i åtgärden "Transcriptions_ListFiles".

TranscriptionProperties

TranskriptionEgenskaper

Name	Typ	Description
channels	integer[]	En samling av de begärda kanalnumren. I standardfallet beaktas kanalerna 0 och 1.
destinationContainerUrl	string	Den begärda målcontainern. Kommentarer När en målcontainer används i kombination med en `timeToLive`tas metadata för en transkription bort normalt, men data som lagras i målcontainern, inklusive transkriptionsresultat, förblir orörda eftersom inga borttagningsbehörigheter krävs för den här containern. Om du vill ha stöd för automatisk rensning kan du antingen konfigurera bloblivslängder för containern eller använda "Byos (Bring Your Own Storage) i stället för `destinationContainerUrl`, där blobar kan rensas.
diarization	DiarizationProperties	DiarizationProperties
diarizationEnabled	boolean	Ett värde som anger om diarisering (talaridentifiering) begärs. Standardvärdet är `false`. Om det här fältet är inställt på sant och det förbättrade diariseringssystemet konfigureras genom att `DiarizationProperties`ange , ger det förbättrade diariseringssystemet diarisering för ett konfigurerbart antal talare. Om det här fältet är inställt på sant och det förbättrade diariseringssystemet inte är aktiverat (anger `DiarizationProperties`inte ) skiljer det grundläggande diariseringssystemet mellan upp till två talare. Inga extra avgifter tillkommer för den grundläggande diariseringen. Det grundläggande diariseringssystemet är inaktuellt och tas bort i nästa huvudversion av API:et. Den här `diarizationEnabled` inställningen tas också bort.
displayFormWordLevelTimestampsEnabled	boolean	Ett värde som anger om tidsstämplar på ordnivå för visningsformuläret begärs. Standardvärdet är `false`.
duration	string	Transkriptionens varaktighet. Varaktigheten kodas som ISO 8601-varaktighet ("PnYnMnDTnHnMnS", se https://en.wikipedia.org/wiki/ISO_8601#Durations).
email	string	E-postadressen som e-postaviseringar ska skickas till om åtgärden slutförs. Värdet tas bort när e-postmeddelandet har skickats.
error	EntityError	EntityError
languageIdentification	LanguageIdentificationProperties	LanguageIdentificationProperties
profanityFilterMode	ProfanityFilterMode	ProfanityFilterMode Läge för svordomsfiltrering.
punctuationMode	PunctuationMode	SkiljeteckenMode Det läge som används för skiljetecken.
timeToLive	string	Hur länge transkriptionen ska behållas i systemet när den har slutförts. När transkriptionen når time to live efter slutförande (lyckad eller misslyckad) tas den bort automatiskt. Om du inte anger det här värdet eller anger 0 inaktiveras automatisk borttagning. Den längsta varaktigheten som stöds är 31 dagar. Varaktigheten kodas som ISO 8601-varaktighet ("PnYnMnDTnHnMnS", se https://en.wikipedia.org/wiki/ISO_8601#Durations).
wordLevelTimestampsEnabled	boolean	Ett värde som anger om tidsstämplar på ordnivå begärs. Standardvärdet är `false`.

TranscriptionUpdate

Name	Typ	Description
customProperties	object	De anpassade egenskaperna för den här entiteten. Den maximala tillåtna nyckellängden är 64 tecken, den maximala tillåtna värdelängden är 256 tecken och antalet tillåtna poster är 10.
description	string	Beskrivningen av objektet.
displayName	string	Namnet på objektet.
project	EntityReference	EntityReference

Dela via

Transcriptions - Update

URI-parametrar

Begärandetext

Svar

Säkerhet

Ocp-Apim-Subscription-Key

Authorization

Exempel

Update a transcription

Exempelbegäran

Exempelsvar

Definitioner

DetailedErrorCode

DiarizationProperties

DiarizationSpeakersProperties

EntityError

EntityReference

Error

ErrorCode

InnerError

LanguageIdentificationMode

LanguageIdentificationProperties

ProfanityFilterMode

PunctuationMode

Status

Transcription

TranscriptionLinks

TranscriptionProperties

Kommentarer

TranscriptionUpdate

Ytterligare resurser