Aracılığıyla paylaş

Text Independent - Identify Single Speaker

  • Başvuru
Hizmet:
Speaker Recognition
API Sürümü:
2021-09-05

Tek Konuşmacı Profilini Tanımlama
Aday profilleri listesi arasında giriş sesinde konuşan kişiyi tanımlar.

Sınırlamalar:

  • En düşük ses girişi uzunluğu 1 saniyedir

  • Maksimum ses girişi uzunluğu 120 saniyedir

  • En az aday konuşmacı sayısı 1'dir

  • En fazla aday konuşmacı sayısı 50'dir

  • En düşük etkili konuşma uzunluğu (sessizlik ve diğer konuşma olmayan kareler hariç) 4 saniyedir Bu sınırlama, "ignoreMinLength" true olarak ayarlanarak devre dışı bırakılabilir.

  • Minimum ses Sinyal-gürültü oranı (SNR) 2dB'dir

POST {endpoint}/speaker-recognition/identification/text-independent/profiles:identifySingleSpeaker?api-version=2021-09-05&profileIds={profileIds}
İsteğe bağlı parametrelerle: 
POST {endpoint}/speaker-recognition/identification/text-independent/profiles:identifySingleSpeaker?api-version=2021-09-05&profileIds={profileIds}&ignoreMinLength={ignoreMinLength}

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).
api-version
 query True

string

Bu istek için kullanılacak işlemin sürümünü belirtir.
profileIds
 query True

string[]

Virgülle ayrılmış profil kimlikleri. Desteklenen en fazla sayı 50 kimliktir.
ignoreMinLength
 query

boolean

Doğruysa, tanımlama için gereken en düşük konuşma miktarı atlanır. Varsayılan değer false’tur.

İstek Başlığı

Media Types: "audio/wav; codecs=audio/pcm"

Name Gerekli Tür Description
Ocp-Apim-Subscription-Key True

string

İstek Gövdesi

Media Types: "audio/wav; codecs=audio/pcm"

Name Tür Description
audioData

object

İkili ses dosyası. Desteklenen biçimler ses/wav; codecs=audio/pcm. 5 MB'a kadar sesi destekler.

Yanıtlar

Name Tür Description
200 OK

IdentifiedSingleSpeakerInfo

Tamam
Other Status Codes

SpeakerErrorInfo

Hata

Üst Bilgiler

x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

Tür: apiKey
İçinde: header

Örnekler

Successful Query

Örnek isteği

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/identification/text-independent/profiles:identifySingleSpeaker?api-version=2021-09-05&profileIds=3669fa29-1bf3-45ad-beea-6b348d058d7e,111f427c-3791-468f-b709-fcef7660fff9,0e196cd9-32d5-4883-8631-54a0e7c7cb3d,0e196cd9-32d5-4883-8631-54a0e7c7cb3d,726e57d9-04e0-4214-b482-7f786fa83560,f95189fd-1bf5-4485-9c2e-e5897e0c98ca


"{binary file date}"

Örnek yanıt

Durum kodu:
200 
Content-Type: application/json
{
  "identifiedProfile": {
    "profileId": "111f427c-3791-468f-b709-fcef7660fff9",
    "score": 0.63
  },
  "profilesRanking": [
    {
      "profileId": "111f427c-3791-468f-b709-fcef7660fff9",
      "score": 0.63
    },
    {
      "profileId": "3669fa29-1bf3-45ad-beea-6b348d058d7e",
      "score": 0.49
    },
    {
      "profileId": "0e196cd9-32d5-4883-8631-54a0e7c7cb3d",
      "score": 0.4
    },
    {
      "profileId": "726e57d9-04e0-4214-b482-7f786fa83560",
      "score": 0.1
    },
    {
      "profileId": "f95189fd-1bf5-4485-9c2e-e5897e0c98ca",
      "score": 0.03
    }
  ]
}
Durum kodu:
default 
Content-Type: application/json
x-ms-error-code: Error Code
{
  "error": {
    "code": "Error Code",
    "message": "Erro Messae"
  }
}

Tanımlar

Name Description
Error
IdentifiedSingleSpeakerInfo
IdentifyInfo

Tanımlanan konuşmacı bilgileri
SpeakerErrorInfo

Konuşmacı hata iletisi

Error

Name Tür Description
code

string

message

string

IdentifiedSingleSpeakerInfo

Name Tür Description
identifiedProfile

IdentifyInfo

Tanımlanan profilin verilerini içeren nesne.
profilesRanking

IdentifyInfo[]

Puana göre azalan düzende sıralanmış ilk 5 profilin (tanımlanan profil dahil) verilerini içeren nesne.

IdentifyInfo

Tanımlanan konuşmacı bilgileri

Name Tür Description
profileId

string

Tanımlanan profilin kimliği. Doğru konuşmacı olarak hiçbir aday tanımlanmadıysa, değer boş GUID olarak ayarlanır.
score

number

Giriş sesi ile hedeflenen ses izi arasındaki benzerliği gösteren bir float numarası. Bu sayı 0 ile 1 arasında olmalıdır. Daha yüksek bir sayı daha yüksek benzerlik anlamına gelir.

SpeakerErrorInfo

Konuşmacı hata iletisi

Name Tür Description
error

Error