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

EntityReference

Yanıtlar

Name Tür Description
200 OK

Transcription

Tamam

Üst Bilgiler

Retry-After: integer

Other Status Codes

Error

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
DetailedErrorCode

DetailedErrorCode

DiarizationProperties

DiarizationProperties

DiarizationSpeakersProperties

DiarizationSpeakersProperties

EntityError

EntityError

EntityReference

EntityReference

Error

Hata

ErrorCode

ErrorCode

InnerError

InnerError

LanguageIdentificationMode

LanguageIdentificationMode

LanguageIdentificationProperties

LanguageIdentificationProperties

ProfanityFilterMode

ProfanityFilterMode

PunctuationMode

Noktalama İşaretiMode

Status

Durum

Transcription

Transkripsiyon

TranscriptionLinks

TranscriptionLinks

TranscriptionProperties

TranscriptionProperties

TranscriptionUpdate

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

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

ErrorCode
Üst düzey hata kodları.

details

Error[]

Hata ve/veya beklenen ilkelerle ilgili ek destek ayrıntıları.

innerError

InnerError

InnerError
adresinde https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owbulunan Bilişsel Hizmetler API Yönergelerine uygun yeni İç Hata biçimi. Bu, ErrorCode, ileti ve isteğe bağlı özellikler hedefi, ayrıntılar (anahtar değer çifti), iç hata (iç içe olabilir) özelliklerini içerir.

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

DetailedErrorCode
Ayrıntılı hata kodu sabit listesi.

details

object

Hata ve/veya beklenen ilkelerle ilgili ek destekleyici ayrıntılar.

innerError

InnerError

InnerError
adresinde https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owbulunan Bilişsel Hizmetler API Yönergelerine uygun yeni İç Hata biçimi. Bu, ErrorCode, ileti ve isteğe bağlı özellik hedefi, ayrıntılar (anahtar değer çifti), iç hata (iç içe olabilir) özelliklerini içerir.

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

LanguageIdentificationMode

Continuous

LanguageIdentificationMode
Dil tanımlama için kullanılan mod.

speechModelMapping

<string,  EntityReference>

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

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

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

EntityReference

project

EntityReference

EntityReference

properties

TranscriptionProperties

TranscriptionProperties

self

string

Bu varlığın konumu.

status

Status

Durum
API'nin geçerli durumunu açıklama

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çıklamalar

Bir hedef kapsayıcı ile timeToLivebirlikte kullanıldığında transkripsiyon meta verileri normal şekilde silinir, ancak bu kapsayıcı için silme izni gerekmediğinden transkripsiyon sonuçları da dahil olmak üzere hedef kapsayıcıda depolanan veriler dokunulmadan kalır.
Otomatik temizlemeyi desteklemek için kapsayıcıda blob yaşamlarını yapılandırın veya blobların temizlenebileceği yerine destinationContainerUrl"Kendi Depolama alanınızı getirin (BYOS)" kullanın.

diarization

DiarizationProperties

DiarizationProperties

diarizationEnabled

boolean

Kesinleştirmenin (konuşmacı belirleme) istenip istenmediğini belirten bir değer. false varsayılan değerdir. Bu alan true olarak ayarlanırsa ve geliştirilmiş diarizasyon sistemi belirtilerek DiarizationPropertiesyapılandırılırsa, geliştirilmiş diarizasyon sistemi yapılandırılabilir bir hoparlör aralığı için darizasyon sağlar. Bu alan true olarak ayarlanırsa ve geliştirilmiş diarizasyon sistemi etkinleştirilmemişse (belirtilmemişse DiarizationProperties), temel diarizasyon sistemi en fazla iki hoparlör arasında ayrım yapacaktır. Temel ayrım için ek ücret uygulanmaz.

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 diarizationEnabled ayar da kaldırılacaktır.

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. false varsayılan değerdir.

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. ).

email

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

EntityError

languageIdentification

LanguageIdentificationProperties

LanguageIdentificationProperties

profanityFilterMode

ProfanityFilterMode

ProfanityFilterMode
Küfür filtreleme modu.

punctuationMode

PunctuationMode

Noktalama İşaretiMode
Noktalama işaretleri için kullanılan mod.

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. false varsayılan değerdir.

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

EntityReference