Toplu transkripsiyon oluşturma

Toplu transkripsiyon işi oluşturmak için konuşmayı metne dönüştürme REST API'sinin Transcriptions_Create işlemini kullanın. İstek gövdesini aşağıdaki yönergelere göre oluşturun:

• veya contentUrls özelliğini ayarlamanız contentContainerUrl gerekir. Toplu transkripsiyon için Azure blob depolama hakkında daha fazla bilgi için bkz . Toplu transkripsiyon için ses dosyalarını bulma.
• Gerekli locale özelliği ayarlayın. Bu değer, döküm için ses verilerinin beklenen yerel ayarıyla eşleşmelidir. Yerel ayarı daha sonra değiştiremezsiniz.
• Gerekli displayName özelliği ayarlayın. Daha sonra başvurabileceğiniz bir transkripsiyon adı seçin. Transkripsiyon adının benzersiz olması gerekmez ve daha sonra değiştirilebilir.
• İsteğe bağlı olarak, temel model dışında bir model kullanmak için özelliğini model kimliği olarak ayarlayın model . Daha fazla bilgi için bkz . Özel model kullanma ve Fısıltı modeli kullanma.
• İsteğe bağlı olarak, döküm sonuçlarında sözcük düzeyi zaman damgalarını etkinleştirmek için özelliğini true olarak ayarlayınwordLevelTimestampsEnabled. Varsayılan değer şudur: false. Fısıltı modelleri için bunun yerine özelliğini ayarlayın displayFormWordLevelTimestampsEnabled . Fısıltı yalnızca görüntüleme modeli olduğundan sözcük alanı transkripsiyonda doldurulmuyor.
• İsteğe bağlı olarak özelliğini ayarlayın languageIdentification . Dil belirleme, desteklenen diller listesiyle karşılaştırıldığında seste konuşulan dilleri tanımlamak için kullanılır. Özelliğini ayarlarsanız languageIdentification , aday yerel ayarlarıyla da ayarlamanız languageIdentification.candidateLocales gerekir.

Daha fazla bilgi için bkz . Yapılandırma seçenekleri isteme.

Aşağıdaki Transcriptions_Create örnekte gösterildiği gibi URI'yi kullanan bir HTTP POST isteği oluşturun.

• değerini Konuşma kaynak anahtarınız ile değiştirin YourSubscriptionKey .
• değerini Konuşma kaynak bölgenizle değiştirin YourServiceRegion .
• İstek gövdesi özelliklerini daha önce açıklandığı gibi ayarlayın.

curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
  "contentUrls": [
    "https://crbn.us/hello.wav",
    "https://crbn.us/whatstheweatherlike.wav"
  ],
  "locale": "en-US",
  "displayName": "My Transcription",
  "model": null,
  "properties": {
    "wordLevelTimestampsEnabled": true,
    "languageIdentification": {
      "candidateLocales": [
        "en-US", "de-DE", "es-ES"
      ],
    }
  },
}'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions"

Aşağıdaki biçimde bir yanıt gövdesi almanız gerekir:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/db474955-ab85-4c6c-ba6e-3bfe63d041ba",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base/5988d691-0893-472c-851e-8e36a0fe7aaf"
  },
  "links": {
    "files": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/db474955-ab85-4c6c-ba6e-3bfe63d041ba/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": true,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "languageIdentification": {
      "candidateLocales": [
        "en-US",
        "de-DE",
        "es-ES"
      ]
    }
  },
  "lastActionDateTime": "2024-05-21T14:18:06Z",
  "status": "NotStarted",
  "createdDateTime": "2024-05-21T14:18:06Z",
  "locale": "en-US",
  "displayName": "My Transcription"
}

Yanıt gövdesindeki en üst düzey self özellik transkripsiyonun URI'sini gösterir. Transkripsiyonların URI'sini ve transkripsiyon rapor dosyalarının URI'sini almak için bu URI'yi kullanın. Transkripsiyonu güncelleştirmek veya silmek için de bu URI'yi kullanırsınız.

transkripsiyonlarınızın durumunu Transcriptions_Get işlemiyle sorgulayabilirsiniz.

Sonuçları aldıktan sonra Transcriptions_Delete düzenli olarak hizmetten arayın. Alternatif olarak, sonuçların timeToLive nihai silinmesini sağlamak için özelliğini ayarlayın.

Transkripsiyon oluşturmak için komutunu kullanın spx batch transcription create . İstek parametrelerini aşağıdaki yönergelere göre oluşturun:

• Gerekli content parametreyi ayarlayın. Tek tek dosyaların virgülle ayrılmış listesini veya kapsayıcının tamamının URL'sini belirtebilirsiniz. Toplu transkripsiyon için Azure blob depolama hakkında daha fazla bilgi için bkz . Toplu transkripsiyon için ses dosyalarını bulma.
• Gerekli language özelliği ayarlayın. Bu değer, döküm için ses verilerinin beklenen yerel ayarıyla eşleşmelidir. Yerel ayarı daha sonra değiştiremezsiniz. Konuşma CLI language parametresi, JSON isteğindeki ve yanıttaki özelliğine karşılık gelir locale .
• Gerekli name özelliği ayarlayın. Daha sonra başvurabileceğiniz bir transkripsiyon adı seçin. Transkripsiyon adının benzersiz olması gerekmez ve daha sonra değiştirilebilir. Konuşma CLI name parametresi, JSON isteğindeki ve yanıttaki özelliğine karşılık gelir displayName .

Aşağıda transkripsiyon işi oluşturan örnek bir Konuşma CLI komutu verilmişti:

spx batch transcription create --name "My Transcription" --language "en-US" --content https://crbn.us/hello.wav,https://crbn.us/whatstheweatherlike.wav

Aşağıdaki biçimde bir yanıt gövdesi almanız gerekir:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/7f4232d5-9873-47a7-a6f7-4a3f00d00dc0",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base/5988d691-0893-472c-851e-8e36a0fe7aaf"
  },
  "links": {
    "files": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/7f4232d5-9873-47a7-a6f7-4a3f00d00dc0/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked"
  },
  "lastActionDateTime": "2024-05-21T14:21:59Z",
  "status": "NotStarted",
  "createdDateTime": "2024-05-21T14:21:59Z",
  "locale": "en-US",
  "displayName": "My Transcription",
  "description": ""
}

Yanıt gövdesindeki en üst düzey self özellik transkripsiyonun URI'sini gösterir. Transkripsiyonların URI'sini ve transkripsiyon rapor dosyalarının URI'sini almak için bu URI'yi kullanın. Transkripsiyonu güncelleştirmek veya silmek için de bu URI'yi kullanırsınız.

Transkripsiyonlarla ilgili Konuşma CLI'sı yardımı için aşağıdaki komutu çalıştırın:

spx help batch transcription

Transcriptions_Create işlemini çağırdığınızda transkripsiyonu yapılandırmak için bazı özellik seçenekleri aşağıdadır. Dil belirleme ile transkripsiyon oluşturma gibi daha fazla örneği aynı sayfada bulabilirsiniz.

Transkripsiyon yapılandırma seçenekleriyle ilgili Konuşma CLI'sı yardımı için aşağıdaki komutu çalıştırın:

spx help batch transcription create advanced

curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
  "contentUrls": [
    "https://crbn.us/hello.wav",
    "https://crbn.us/whatstheweatherlike.wav"
  ],
  "locale": "en-US",
  "displayName": "My Transcription",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base/5988d691-0893-472c-851e-8e36a0fe7aaf"
  },
  "properties": {
    "wordLevelTimestampsEnabled": true,
  },
}'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions"

spx batch transcription create --name "My Transcription" --language "en-US" --content https://crbn.us/hello.wav,https://crbn.us/whatstheweatherlike.wav --model "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base/5988d691-0893-472c-851e-8e36a0fe7aaf"

Tüm yerel ayarlar için kullanılabilir temel modelleri almak için Models_ListBaseModels isteğinde bulunabilirsiniz.

Bölge için aşağıdaki örnekte gösterildiği gibi bir HTTP GET isteği oluşturun eastus . değerini Konuşma kaynak anahtarınız ile değiştirin YourSubscriptionKey . Farklı bir bölge kullanıyorsanız değiştirin eastus .

curl -v -X GET "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"

Varsayılan olarak, yalnızca en eski 100 temel model döndürülür. Sonuçları sayfalandırmak skip için ve top sorgu parametrelerini kullanın. Örneğin, aşağıdaki istek ilk 100'lerden sonraki 100 temel modeli döndürür.

curl -v -X GET "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base?skip=100&top=100" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"

Desteklenen bölgelerden birinde konuşma kaynağı için yapılandırma değişkenlerini ayarladığınızdan emin olun. Tüm yerel ayarlar için kullanılabilir temel modelleri almak için komutunu çalıştırabilirsiniz spx csr list --base .

spx csr list --base --api-version v3.2

Bölge için bu örnekte gösterildiği gibi tam model URI'sini eastus ayarlarsınız. değerini Konuşma kaynak anahtarınız ile değiştirin YourSubscriptionKey . Farklı bir bölge kullanıyorsanız değiştirin eastus .

curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
  "contentUrls": [
    "https://crbn.us/hello.wav",
    "https://crbn.us/whatstheweatherlike.wav"
  ],
  "locale": "en-US",
  "displayName": "My Transcription",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base/e418c4a9-9937-4db7-b2c9-8afbff72d950"
  },
  "properties": {
    "wordLevelTimestampsEnabled": true,
  },
}'  "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions"

Bölge için bu örnekte gösterildiği gibi tam model URI'sini eastus ayarlarsınız. Farklı bir bölge kullanıyorsanız değiştirin eastus .

spx batch transcription create --name "My Transcription" --language "en-US" --content https://crbn.us/hello.wav,https://crbn.us/whatstheweatherlike.wav --model "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base/e418c4a9-9937-4db7-b2c9-8afbff72d950" --api-version v3.2