Transcriptions - Update
Kimliğiyle tanımlanan transkripsiyonun değiştirilebilir ayrıntılarını Güncelleştirmeler.
PATCH {endpoint}/speechtotext/v3.2-preview.2/transcriptions/{id}
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve konak adı, örneğin: https://westus.api.cognitive.microsoft.com). |
id
|
path | True |
string uuid |
Transkripsiyonun tanımlayıcısı. |
İstek Gövdesi
Media Types: "application/json", "application/merge-patch+json"
Name | Tür | Description |
---|---|---|
customProperties |
object |
Bu varlığın özel özellikleri. İzin verilen anahtar uzunluğu üst sınırı 64 karakter, izin verilen değer uzunluğu üst sınırı 256 karakter ve izin verilen girdi sayısı 10'dur. |
description |
string |
Nesnenin açıklaması. |
displayName |
string |
Nesnenin adı. |
project |
EntityReference |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam Üst Bilgiler Retry-After: integer |
|
Other Status Codes |
Bir hata oluşmuştur. |
Güvenlik
Ocp-Apim-Subscription-Key
Bilişsel hizmetler hesap anahtarınızı burada sağlayın.
Tür:
apiKey
İçinde:
header
Authorization
Bu bölgenin STS tarafından döndürülen JWT'den bir erişim belirteci sağlayın. STS URL'sine aşağıdaki sorgu dizesini ekleyerek yönetim kapsamını belirteci eklediğinizden emin olun: ?scope=speechservicesmanagement
Tür:
apiKey
İçinde:
header
Örnekler
Update a transcription
Örnek isteği
PATCH {endpoint}/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683
{
"displayName": "Updated transcription name",
"description": "Updated transcription description",
"customProperties": {
"key": "value"
}
}
Örnek yanıt
{
"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"
}
}
Tanımlar
Name | Description |
---|---|
Detailed |
DetailedErrorCode |
Diarization |
DiarizationProperties |
Diarization |
DiarizationSpeakersProperties |
Entity |
EntityError |
Entity |
EntityReference |
Error |
Hata |
Error |
ErrorCode |
Inner |
InnerError |
Language |
LanguageIdentificationMode |
Language |
LanguageIdentificationProperties |
Profanity |
ProfanityFilterMode |
Punctuation |
Noktalama İşaretiMode |
Status |
Durum |
Transcription |
Transkripsiyon |
Transcription |
TranscriptionLinks |
Transcription |
TranscriptionProperties |
Transcription |
TranscriptionUpdate |
DetailedErrorCode
DetailedErrorCode
Name | Tür | Description |
---|---|---|
DataImportFailed |
string |
Veri içeri aktarılamadı. |
DeleteNotAllowed |
string |
Silmeye izin verilmiyor. |
DeployNotAllowed |
string |
Dağıtıma izin verilmiyor. |
DeployingFailedModel |
string |
Başarısız modeli dağıtma. |
EmptyRequest |
string |
Boş İstek. |
EndpointCannotBeDefault |
string |
Uç nokta varsayılan olamaz. |
EndpointNotUpdatable |
string |
Uç nokta güncelleştirilebilir değil. |
EndpointWithoutLogging |
string |
Günlüğe kaydetmeden uç nokta. |
ExceededNumberOfRecordingsUris |
string |
Kayıt sayısı uris aşıldı. |
FailedDataset |
string |
Başarısız veri kümesi. |
Forbidden |
string |
Yasak. |
InUseViolation |
string |
Kullanım ihlali. |
InaccessibleCustomerStorage |
string |
Erişilemez müşteri depolama alanı. |
InvalidAdaptationMapping |
string |
Geçersiz uyarlama eşlemesi. |
InvalidBaseModel |
string |
Geçersiz temel model. |
InvalidCallbackUri |
string |
Geçersiz geri çağırma uri'si. |
InvalidCollection |
string |
Geçersiz koleksiyon. |
InvalidDataset |
string |
Geçersiz veri kümesi. |
InvalidDocument |
string |
Geçersiz Belge. |
InvalidDocumentBatch |
string |
Geçersiz Belge Toplu İşlemi. |
InvalidLocale |
string |
Geçersiz yerel ayar. |
InvalidLogDate |
string |
Geçersiz günlük tarihi. |
InvalidLogEndTime |
string |
Geçersiz günlük bitiş saati. |
InvalidLogId |
string |
Geçersiz günlük kimliği. |
InvalidLogStartTime |
string |
Geçersiz günlük başlangıç zamanı. |
InvalidModel |
string |
Geçersiz model. |
InvalidModelUri |
string |
Geçersiz model uri'si. |
InvalidParameter |
string |
Geçersiz parametre. |
InvalidParameterValue |
string |
Geçersiz parametre değeri. |
InvalidPayload |
string |
Geçersiz yük. |
InvalidPermissions |
string |
Geçersiz izinler. |
InvalidPrerequisite |
string |
Geçersiz önkoşul. |
InvalidProductId |
string |
Geçersiz ürün kimliği. |
InvalidProject |
string |
Geçersiz proje. |
InvalidProjectKind |
string |
Geçersiz proje türü. |
InvalidRecordingsUri |
string |
Geçersiz kayıt uri'si. |
InvalidRequestBodyFormat |
string |
Geçersiz istek gövdesi biçimi. |
InvalidSasValidityDuration |
string |
Geçersiz sas geçerlilik süresi. |
InvalidSkipTokenForLogs |
string |
Günlükler için geçersiz atlama belirteci. |
InvalidSourceAzureResourceId |
string |
Geçersiz kaynak Azure kaynak kimliği. |
InvalidSubscription |
string |
Geçersiz abonelik. |
InvalidTest |
string |
Geçersiz test. |
InvalidTimeToLive |
string |
Geçersiz yaşam süresi. |
InvalidTopForLogs |
string |
Günlükler için geçersiz üst. |
InvalidTranscription |
string |
Geçersiz transkripsiyon. |
InvalidWebHookEventKind |
string |
Geçersiz web kancası olay türü. |
MissingInputRecords |
string |
Eksik Giriş Kayıtları. |
ModelCopyOperationExists |
string |
Model kopyalama işlemi var. |
ModelDeploymentNotCompleteState |
string |
Model dağıtımı tamamlanamadı durumu. |
ModelDeprecated |
string |
Model kullanım dışı bırakıldı. |
ModelExists |
string |
Model var. |
ModelMismatch |
string |
Model uyuşmazlığı. |
ModelNotDeployable |
string |
Model dağıtılamaz. |
ModelVersionIncorrect |
string |
Model Sürümü Yanlış. |
NoUtf8WithBom |
string |
Ürün reçetesi ile utf8 yok. |
OnlyOneOfUrlsOrContainerOrDataset |
string |
Url'lerden, kapsayıcıdan veya veri kümesinden yalnızca biri. |
ProjectGenderMismatch |
string |
Proje cinsiyet uyuşmazlığı. |
QuotaViolation |
string |
Kota ihlali. |
SingleDefaultEndpoint |
string |
Tek varsayılan uç nokta. |
SkuLimitsExist |
string |
Sku sınırları vardır. |
SubscriptionNotFound |
string |
Abonelik bulunamadı. |
UnexpectedError |
string |
Beklenmeyen hata. |
UnsupportedClassBasedAdaptation |
string |
Desteklenmeyen sınıf tabanlı uyarlama. |
UnsupportedDelta |
string |
Desteklenmeyen delta. |
UnsupportedDynamicConfiguration |
string |
Desteklenmeyen dinamik yapılandırma. |
UnsupportedFilter |
string |
Desteklenmeyen filtre. |
UnsupportedLanguageCode |
string |
Desteklenmeyen dil kodu. |
UnsupportedOrderBy |
string |
Desteklenmeyen sipariş ölçütü. |
UnsupportedPagination |
string |
Desteklenmeyen sayfalandırma. |
UnsupportedTimeRange |
string |
Desteklenmeyen zaman aralığı. |
DiarizationProperties
DiarizationProperties
Name | Tür | Description |
---|---|---|
speakers |
DiarizationSpeakersProperties |
DiarizationSpeakersProperties
DiarizationSpeakersProperties
Name | Tür | Description |
---|---|---|
maxCount |
integer |
Kesinleştirme için maksimum hoparlör sayısı. 36'dan küçük ve minSpeakers özelliğinden büyük veya ona eşit olmalıdır. |
minCount |
integer |
Darizasyon için en az hoparlör sayısına ilişkin bir ipucu. maxSpeakers özelliğinden küçük veya buna eşit olmalıdır. |
EntityError
EntityError
Name | Tür | Description |
---|---|---|
code |
string |
Bu hatanın kodu. |
message |
string |
Bu hatanın iletisi. |
EntityReference
EntityReference
Name | Tür | Description |
---|---|---|
self |
string |
Başvuruda bulunılan varlığın konumu. |
Error
Hata
Name | Tür | Description |
---|---|---|
code |
ErrorCode |
|
details |
Error[] |
Hata ve/veya beklenen ilkelerle ilgili ek destek ayrıntıları. |
innerError |
InnerError |
|
message |
string |
Üst düzey hata iletisi. |
target |
string |
Hatanın kaynağı. Örneğin, geçersiz belge olması durumunda "belgeler" veya "belge kimliği" olabilir. |
ErrorCode
ErrorCode
Name | Tür | Description |
---|---|---|
Conflict |
string |
Çakışma hata kodunu temsil ediyor. |
Forbidden |
string |
Yasak hata kodunu temsil ediyor. |
InternalCommunicationFailed |
string |
İç iletişim başarısız hata kodunu temsil eder. |
InternalServerError |
string |
İç sunucu hata kodunu temsil etme. |
InvalidArgument |
string |
Geçersiz bağımsız değişken hata kodunu temsil ediyor. |
InvalidRequest |
string |
Geçersiz istek hata kodunu temsil ediyor. |
NotAllowed |
string |
İzin verilmeyen hata kodunu temsil ediyor. |
NotFound |
string |
Bulunamadı hata kodunu temsil ediyor. |
PipelineError |
string |
İşlem hattı hata kodunu temsil eder. |
ServiceUnavailable |
string |
Hizmet kullanılamıyor hata kodunu temsil etme. |
TooManyRequests |
string |
Çok fazla istek hata kodunu temsil eder. |
Unauthorized |
string |
Yetkisiz hata kodunu temsil etme. |
UnprocessableEntity |
string |
İşlenemeyen varlık hata kodunu temsil eder. |
UnsupportedMediaType |
string |
Desteklenmeyen medya türü hata kodunu temsil eder. |
InnerError
InnerError
Name | Tür | Description |
---|---|---|
code |
DetailedErrorCode |
|
details |
object |
Hata ve/veya beklenen ilkelerle ilgili ek destekleyici ayrıntılar. |
innerError |
InnerError |
|
message |
string |
Üst düzey hata iletisi. |
target |
string |
Hatanın kaynağı. Örneğin, geçersiz belge olması durumunda "belgeler" veya "belge kimliği" olabilir. |
LanguageIdentificationMode
LanguageIdentificationMode
Name | Tür | Description |
---|---|---|
Continuous |
string |
Sürekli dil belirleme (Varsayılan). |
Single |
string |
Tek dilli tanımlama. |
LanguageIdentificationProperties
LanguageIdentificationProperties
Name | Tür | Default value | Description |
---|---|---|---|
candidateLocales |
string[] |
Dil belirleme için aday yerel ayarlar (örnek ["en-US", "de-DE", "es-ES"]). Transkripsiyon için ana yerel ayar dahil olmak üzere en az 2 ve en fazla 10 aday yerel ayar desteklenir. |
|
mode | Continuous |
LanguageIdentificationMode |
|
speechModelMapping |
<string,
Entity |
Yerel ayarların konuşma modeli varlıklarına isteğe bağlı eşlemesi. Yerel ayar için model verilmezse varsayılan temel model kullanılır. Anahtarlar aday yerel ayarlarda bulunan yerel ayarlar olmalı, değerler ilgili yerel ayarların modelleri için varlıklardır. |
ProfanityFilterMode
ProfanityFilterMode
Name | Tür | Description |
---|---|---|
Masked |
string |
İlk harf dışında küfürleri * ile maskele, örneğin, f** |
None |
string |
Küfür filtrelemeyi devre dışı bırakın. |
Removed |
string |
Küfürleri kaldır. |
Tags |
string |
"Küfür" XML etiketleri</Küfür ekleme> |
PunctuationMode
Noktalama İşaretiMode
Name | Tür | Description |
---|---|---|
Automatic |
string |
Otomatik noktalama işaretleri. |
Dictated |
string |
Yalnızca dikte edilen noktalama işaretleri, yani açık noktalama işaretleri. |
DictatedAndAutomatic |
string |
Dikte edilen noktalama işaretleri veya otomatik noktalama işaretleri. |
None |
string |
Noktalama işareti yok. |
Status
Durum
Name | Tür | Description |
---|---|---|
Failed |
string |
Uzun süre çalışan işlem başarısız oldu. |
NotStarted |
string |
Uzun süre çalışan işlem henüz başlatılmadı. |
Running |
string |
Uzun süre çalışan işlem şu anda işleniyor. |
Succeeded |
string |
Uzun süre çalışan işlem başarıyla tamamlandı. |
Transcription
Transkripsiyon
Name | Tür | Description |
---|---|---|
contentContainerUrl |
string |
Ses dosyalarını içeren bir Azure blob kapsayıcısının URL'si. Kapsayıcının boyutu en fazla 5 GB ve en fazla 10000 blob olabilir. Blob için boyut üst sınırı 2,5 GB'tır. Kapsayıcı SAS'sı 'r' (okuma) ve 'l' (liste) izinlerini içermelidir. Bu özellik bir yanıtta döndürülmeyecek. |
contentUrls |
string[] |
Ses dosyalarının dökümünü almak için içerik URL'lerinin listesi. En fazla 1000 URL'ye izin verilir. Bu özellik bir yanıtta döndürülmeyecek. |
createdDateTime |
string |
Nesnenin oluşturulduğu zaman damgası. Zaman damgası ISO 8601 tarih ve saat biçimi olarak kodlanmıştır ("YYYY-AA-GGThh:mm:ssZ", bkz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations. ). |
customProperties |
object |
Bu varlığın özel özellikleri. İzin verilen anahtar uzunluğu üst sınırı 64 karakter, izin verilen değer uzunluğu üst sınırı 256 karakter ve izin verilen girdi sayısı 10'dur. |
dataset |
EntityReference |
|
description |
string |
Nesnenin açıklaması. |
displayName |
string |
Nesnenin görünen adı. |
lastActionDateTime |
string |
Geçerli durumun girildiği zaman damgası. Zaman damgası ISO 8601 tarih ve saat biçimi olarak kodlanmıştır ("YYYY-AA-GGThh:mm:ssZ", bkz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations. ). |
links |
TranscriptionLinks |
|
locale |
string |
Kapsanan verilerin yerel ayarı. Dil Belirleme kullanılırsa, dil algılanamayan konuşmanın dökümünü almak için bu yerel ayar kullanılır. |
model |
EntityReference |
|
project |
EntityReference |
|
properties |
TranscriptionProperties |
|
self |
string |
Bu varlığın konumu. |
status |
Durum |
TranscriptionLinks
TranscriptionLinks
Name | Tür | Description |
---|---|---|
files |
string |
Bu varlığın tüm dosyalarını almak için konum. Daha fazla ayrıntı için bkz. "Transcriptions_ListFiles" işlemi. |
TranscriptionProperties
TranscriptionProperties
Name | Tür | Description |
---|---|---|
channels |
integer[] |
İstenen kanal numaralarının koleksiyonu. Varsayılan durumda 0 ve 1 kanalları dikkate alınır. |
destinationContainerUrl |
string |
İstenen hedef kapsayıcı. AçıklamalarBir hedef kapsayıcı ile |
diarization |
DiarizationProperties |
|
diarizationEnabled |
boolean |
Kesinleştirmenin (konuşmacı belirleme) istenip istenmediğini belirten bir değer.
Temel dağıtım sistemi kullanım dışıdır ve API'nin bir sonraki ana sürümünde kaldırılacaktır.
Bu |
displayFormWordLevelTimestampsEnabled |
boolean |
Görüntüleme formu için sözcük düzeyi zaman damgalarının istenip istenmediğini belirten bir değer.
|
duration |
string |
Transkripsiyonun süresi. Süre ISO 8601 süresi olarak kodlanmıştır ("PnYnMnDTnHnMnS", bkz https://en.wikipedia.org/wiki/ISO_8601#Durations. ). |
string |
İşlemin tamamlanması durumunda adresine e-posta bildirimleri gönderilecek e-posta adresi. Değer, e-posta başarıyla gönderildikten sonra kaldırılır. |
|
error |
EntityError |
|
languageIdentification |
LanguageIdentificationProperties |
|
profanityFilterMode |
ProfanityFilterMode |
|
punctuationMode |
Noktalama İşaretiMode |
|
timeToLive |
string |
Transkripsiyon tamamlandıktan sonra sistemde ne kadar süre tutulacak? Transkripsiyon tamamlandıktan (başarılı veya başarısız) sonra yaşam süresine ulaştığında otomatik olarak silinir. Bu değeri ayarlamamak veya 0 olarak ayarlamak otomatik silmeyi devre dışı bırakır. Desteklenen en uzun süre 31 gündür. Süre ISO 8601 süresi olarak kodlanmıştır ("PnYnMnDTnHnMnS", bkz https://en.wikipedia.org/wiki/ISO_8601#Durations. ). |
wordLevelTimestampsEnabled |
boolean |
Sözcük düzeyi zaman damgalarının istenip istenmediğini belirten bir değer.
|
TranscriptionUpdate
TranscriptionUpdate
Name | Tür | Description |
---|---|---|
customProperties |
object |
Bu varlığın özel özellikleri. İzin verilen anahtar uzunluğu üst sınırı 64 karakter, izin verilen değer uzunluğu üst sınırı 256 karakter ve izin verilen girdi sayısı 10'dur. |
description |
string |
Nesnenin açıklaması. |
displayName |
string |
Nesnenin adı. |
project |
EntityReference |