Kodu v 2.0 'dan v 3.0 'a geçirin REST API

V2 ile karşılaştırıldığında, konuşma hizmetlerinin, konuşmadan metne REST API v3 sürümü daha güvenilirdir, kullanımı daha kolaydır ve benzer hizmetler için API 'lerle daha tutarlıdır. Çoğu takım, günde bir veya iki adımda v2 'den v3 'e geçiş yapabilir.

İleriye dönük uyumluluk

V2 'nin tüm varlıkları aynı kimliğin altındaki v3 API 'sinde de bulunabilir. Bir sonucun şemasının değiştiği (örneğin, döküm), API 'nin v3 sürümündeki bir GET 'in sonucu v3 şemasını kullanır. API 'nin v2 sürümündeki bir GET 'in sonucu aynı v2 şemasını kullanır. V3 üzerinde yeni oluşturulan varlıklar ****   v2 API 'lerinden gelen yanıtlardan kullanılamaz.

Geçiş adımları

Bu, geçiş için hazırlanırken bilmeniz gereken öğelerin Özet listesidir. Ayrıntılar tek tek bağlantılarda bulunur. API 'nin geçerli kullanımına bağlı olarak burada listelenen adımların hepsi geçerli olabilir. Yalnızca birkaç değişiklik, çağıran kodda önemsiz olmayan değişiklikler gerektirir. Çoğu değişiklik yalnızca öğe adlarında değişiklik yapılmasını gerektirir.

Genel değişiklikler:

  1. Ana bilgisayar adını değiştirme

  2. Özellik kimliğini istemci kodunuzda kendi kendine yeniden adlandırın

  3. Varlıkların koleksiyonları üzerinde yinelemek için kodu değiştirin

  4. Özellik adını istemci kodunuzda displayName olarak yeniden adlandırın

  5. Başvurulan varlıkların meta verilerinin alınmasını ayarla

  6. Batch dökümünü kullanıyorsanız:

  7. Özel model eğitimi ve test API 'Leri kullanıyorsanız:

  8. Uç nokta API 'Leri kullanıyorsanız:

  9. Diğer küçük değişiklikler:

Yeni değişiklikler

Ana bilgisayar adı değişiklikleri

Uç nokta ana bilgisayar adları iken {region}.cris.ai olarak değiştirildi {region}.api.cognitive.microsoft.com . Yeni uç noktalara yönelik yollar artık api/ ana bilgisayar adının bir parçası olduğundan içermez. Swagger belgesi geçerli bölgeleri ve yolları listeler.

Önemli

Ana bilgisayar adını, {region}.cris.ai konuşma aboneliğinizin bölgesi olan bölge adıyla değiştirin {region}.api.cognitive.microsoft.com . Ayrıca api/ , istemci kodunuzda herhangi bir yoldan kaldırın.

Bir varlığın kimliği

Özelliği id artık self . V2 sürümünde bir API kullanıcısının, API 'deki yollarımızı nasıl oluşturduğumuzu öğrenmiş olması gerekiyordu. Bu, Genişletilebilir olmayan ve Kullanıcı tarafından gerekli olan gereksiz çalışmamıştı. Özelliği ( id UUID), self VARLıĞıN (URL) konumu olan (dize) ile değiştirilmiştir. Değer, tüm varlıklarınız arasında hala benzersizdir. idKodunuzda bir dize olarak depolanıyorsa, yeni şemayı desteklemek için yeniden adlandırma yeterlidir. Artık self içeriği GET , PATCH varlığınızın,, ve REST çağrılarının URL 'si olarak kullanabilirsiniz DELETE .

Varlığın diğer yollarla kullanılabilir ek işlevleri varsa, bunlar altında listelenir links . Aşağıdaki örnek, döküm içeriğine ayrı bir yöntemi gösterir GET :

Önemli

Özelliği id istemci kodunuzda olarak yeniden adlandırın self . Türünü, uuid gerekirse olarak değiştirin string .

v2 dökümü:

{
    "id": "9891c965-bb32-4880-b14b-6d44efb158f3",
    "createdDateTime": "2019-01-07T11:34:12Z",
    "lastActionDateTime": "2019-01-07T11:36:07Z",
    "status": "Succeeded",
    "locale": "en-US",
    "name": "Transcription using locale en-US"
}

v3 dökümü:

{
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/transcriptions/9891c965-bb32-4880-b14b-6d44efb158f3",
    "createdDateTime": "2019-01-07T11:34:12Z",
    "lastActionDateTime": "2019-01-07T11:36:07Z",
    "status": "Succeeded",
    "locale": "en-US", 
    "displayName": "Transcription using locale en-US",
    "links": {
      "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/transcriptions/9891c965-bb32-4880-b14b-6d44efb158f3/files"
    }
}

Kodunuzun uygulamasına bağlı olarak, özelliğin yeniden adlandırılması yeterli olmayabilir. Döndürülen self ve links değerlerin, istemcinizdeki yolları oluşturmak yerine Rest aramalarınızın hedef URL 'leri olarak kullanılması önerilir. Döndürülen URL 'Leri kullanarak, yollardaki gelecekteki değişikliklerin istemci kodunuzu bozmadığından emin olabilirsiniz.

Varlık koleksiyonlarıyla çalışma

Daha önce v2 API 'SI, bir sonuç içinde tüm kullanılabilir varlıkları döndürdü. V3 'de beklenen yanıt boyutu üzerinde daha ayrıntılı bir denetime izin vermek için tüm koleksiyon sonuçlarının sayfalandırılmış olması gerekir. Döndürülen varlıkların sayısı ve sayfanın başlangıç kayması üzerinde denetiminiz vardır. Bu davranış, yanıt işlemcisinin çalışma zamanının önlanmasını kolaylaştırır.

Yanıtın temel şekli tüm koleksiyonlar için aynıdır:

{
    "values": [
        {     
        }
    ],
    "@nextLink": "https://{region}.api.cognitive.microsoft.com/speechtotext/v3.0/{collection}?skip=100&top=100"
}

valuesÖzelliği, kullanılabilir koleksiyon varlıklarının bir alt kümesini içerir. Sayı ve konum, skip ve top sorgu parametreleri kullanılarak denetlenebilir. Ne zaman yoksa @nextLink null , daha fazla veri mevcuttur ve bir sonraki veri grubu bir get işlemi yaparak alınabilir $.@nextLink .

Bu değişiklik, GET tüm öğeler döndürülünceye kadar bir döngüde koleksiyon için çağrılmasını gerektirir.

Önemli

Bir alma işleminin yanıtı speechtotext/v3.0/{collection} ' de bir değeri içerdiğinde $.@nextLink , GETs $.@nextLink $.@nextLink Bu koleksiyonun tüm öğelerini almak için ayarlanana kadar üzerinde verme işlemine devam edin.

Döküm oluşturma

Toplu iş dökümlerinin nasıl yapılacağıhakkında ayrıntılı bir açıklama, toplu olarak nasıl yapılır? bölümünde bulunabilir.

V3 dökümü API 'SI, belirli döküm seçeneklerini açıkça ayarlamanıza olanak sağlar. Tüm (isteğe bağlı) yapılandırma özellikleri artık properties özellikte ayarlanabilir. V3 sürümü birden çok giriş dosyasını da destekler, bu nedenle v2 'nin bulunduğu tek URL yerine URL 'lerin bir listesini gerektirir. V2 Özellik adı recordingsUrl artık v3 'dir contentUrls . Analbetiklerde yaklaşım çözümleme işlevselliği v3 'de kaldırılmıştır. Yaklaşım Analizi seçenekleri için bkz. Microsoft bilişsel hizmet metin analizi .

Altındaki yeni özellik timeToLive , properties var olan tamamlanmış varlıkların ayıklayıp sağlanmasına yardımcı olabilir. , timeToLive Tamamlanan bir varlığın otomatik olarak silineceği süreyi belirtir. PT12HVarlıkların sürekli olarak izlendiği, tüketildiği ve silindiği ve bu nedenle genellikle 12 saat geçtikten sonra uzun süre işlendiği zaman, yüksek bir değere ayarlayın (örneğin).

v2 istek SONRASı isteği gövdesi:

{
  "locale": "en-US",
  "name": "Transcription using locale en-US",
  "recordingsUrl": "https://contoso.com/mystoragelocation",
  "properties": {
    "AddDiarization": "False",
    "AddWordLevelTimestamps": "False",
    "PunctuationMode": "DictatedAndAutomatic",
    "ProfanityFilterMode": "Masked"
  }
}

v3 döküm istek gövdesi:

{
  "locale": "en-US",
  "displayName": "Transcription using locale en-US",
  "contentUrls": [
    "https://contoso.com/mystoragelocation",
    "https://contoso.com/myotherstoragelocation"
  ],
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked"
  }
}

Önemli

Özelliğini, recordingsUrl contentUrls tek bir URL yerine bir URL dizisi olarak yeniden adlandırın ve geçirin. diarizationEnabledYa da yerine için ayarları geçirin wordLevelTimestampsEnabled bool string .

V3 dökümü sonuçlarının biçimi

Döküm sonuçlarının şeması, gerçek zamanlı uç noktalar tarafından oluşturulan dökümlerle hizalı olarak değiştirilmiştir. Toplu iş dökümünü nasıl yapılırbölümünde yeni biçimin derinlemesine bir açıklamasını bulun. sonucun şeması, altında GitHub örnek depoımızda yayımlanır samples/batch/transcriptionresult_v3.schema.json .

Özellik adları artık Camel-cased ve için değerleri ve channel speaker artık tamsayı türlerini kullanır. Süreler için biçimlendirme artık ISO 8601 ' de açıklanan yapıyı kullanarak, diğer Azure API 'Lerinde kullanılan süre biçimlendirmesiyle eşleşir.

Bir v3 dökümü sonucunun örneği. Farklar açıklamalarda açıklanmıştır.

{
  "source": "...",                      // (new in v3) was AudioFileName / AudioFileUrl
  "timestamp": "2020-06-16T09:30:21Z",  // (new in v3)
  "durationInTicks": 41200000,          // (new in v3) was AudioLengthInSeconds
  "duration": "PT4.12S",                // (new in v3)
  "combinedRecognizedPhrases": [        // (new in v3) was CombinedResults
    {
      "channel": 0,                     // (new in v3) was ChannelNumber
      "lexical": "hello world",
      "itn": "hello world",
      "maskedITN": "hello world",
      "display": "Hello world."
    }
  ],
  "recognizedPhrases": [                // (new in v3) was SegmentResults
    {
      "recognitionStatus": "Success",   // 
      "channel": 0,                     // (new in v3) was ChannelNumber
      "offset": "PT0.07S",              // (new in v3) new format, was OffsetInSeconds
      "duration": "PT1.59S",            // (new in v3) new format, was DurationInSeconds
      "offsetInTicks": 700000.0,        // (new in v3) was Offset
      "durationInTicks": 15900000.0,    // (new in v3) was Duration

      // possible transcriptions of the current phrase with confidences
      "nBest": [
        {
          "confidence": 0.898652852,phrase
          "speaker": 1,
          "lexical": "hello world",
          "itn": "hello world",
          "maskedITN": "hello world",
          "display": "Hello world.",

          "words": [
            {
              "word": "hello",
              "offset": "PT0.09S",
              "duration": "PT0.48S",
              "offsetInTicks": 900000.0,
              "durationInTicks": 4800000.0,
              "confidence": 0.987572
            },
            {
              "word": "world",
              "offset": "PT0.59S",
              "duration": "PT0.16S",
              "offsetInTicks": 5900000.0,
              "durationInTicks": 1600000.0,
              "confidence": 0.906032
            }
          ]
        }
      ]
    }
  ]
}

Önemli

Döküm sonucunun, yukarıda gösterildiği gibi yeni türe seri durumdan çıkarılması. Her ses kanalı başına tek bir dosya yerine, channel içindeki her öğe için özellik değerini denetleyerek kanalları ayırt edin recognizedPhrases . Her giriş dosyası için artık tek bir sonuç dosyası vardır.

Varlıkların içeriğini ve sonuçlarını alma

V2 'de, giriş veya sonuç dosyalarının bağlantıları, varlık meta verileri geri kalanı ile birlikte satır içine alındı. V3 'de bir geliştirme olarak, varlık meta verileri (bir GET ile döndürülen $.self ) ve sonuç dosyalarına erişmek için Ayrıntılar ve kimlik bilgileri arasında net bir ayrım vardır. Bu ayrım, müşteri verilerinin korunmasına yardımcı olur ve kimlik bilgilerinin geçerlilik süresi boyunca ince denetim sağlar.

v3'te, varlığın verileri (veri kümeleri, transkripsiyonlar, uç noktalar veya değerlendirmeler) açığa çıkarması durumunda adlı bir links files alt özelliği dahil etmek. Get on $.links.files dosyası, dosyaların listesini ve her bir dosyanın içeriğine erişmek için bir SAS URL'si geri döner. SAS URL'lerinin geçerlilik süresini kontrol etmek için sorgu sasValidityInSeconds parametresi, yaşam süresini belirtmek için kullanılabilir.

v2 transkripsiyonu:

{
  "id": "9891c965-bb32-4880-b14b-6d44efb158f3",
  "status": "Succeeded",
  "reportFileUrl": "https://contoso.com/report.txt?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=6c044930-3926-4be4-be76-f728327c53b5",
  "resultsUrls": {
    "channel_0": "https://contoso.com/audiofile1.wav?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=6c044930-3926-4be4-be76-f72832e6600c",
    "channel_1": "https://contoso.com/audiofile2.wav?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=3e0163f1-0029-4d4a-988d-3fba7d7c53b5"
  }
}

v3 transkripsiyonu:

{
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/transcriptions/9891c965-bb32-4880-b14b-6d44efb158f3",
    "links": {
      "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/transcriptions/9891c965-bb32-4880-b14b-6d44efb158f3/files"
    } 
}

Get on şu $.links.files şekilde sonuçlandır:

{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/transcriptions/9891c965-bb32-4880-b14b-6d44efb158f3/files/f23e54f5-ed74-4c31-9730-2f1a3ef83ce8",
      "name": "Name",
      "kind": "Transcription",
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/mywavefile1.wav.json?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=e05d8d56-9675-448b-820c-4318ae64c8d5"
      }
    },
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/transcriptions/9891c965-bb32-4880-b14b-6d44efb158f3/files/28bc946b-c251-4a86-84f6-ea0f0a2373ef",
      "name": "Name",
      "kind": "TranscriptionReport",
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/report.json?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=e05d8d56-9675-448b-820c-4318ae64c8d5"
      }
    }
  ],
  "@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/transcriptions/9891c965-bb32-4880-b14b-6d44efb158f3/files?skip=2&top=2"
}

kindözelliği, dosya içeriğinin biçimini gösterir. Transkripsiyonlar için, tür dosyaları işin özetidir ve tür TranscriptionReport dosyaları işin Transcription sonucudur.

Önemli

İşlemlerin sonuçlarını almak için üzerinde kullanın. Bunlar artık veya GET /speechtotext/v3.0/{collection}/{id}/files yanıtlarında GET yer /speechtotext/v3.0/{collection}/{id} almayan /speechtotext/v3.0/{collection} .

Modelleri özelleştirme

v3'den önce, bir model eğitilmişken akustik model ile dil modeli arasında ayrım vardı. Bu ayrım, uç noktaları veya transkripsiyonları oluştururken birden çok model belirtme ihtiyacıyla sonuçlandı. Çağıran için bu işlemi basitleştirmek için farkları kaldırdık ve her şeyin model eğitimi için kullanılan veri kümelerinin içeriğine bağlı olduğunu yaptık. Bu değişiklikle birlikte model oluşturma işlemi artık karma veri kümelerini (dil verileri ve akustik veriler) destekliyor. Uç noktalar ve transkripsiyonlar artık yalnızca bir model gerektirir.

Bu değişiklikle, işlemde bir ihtiyacı kaldırılmıştır ve dizi artık aynı veya karışık türlerde birden kind POST çok veri kümesi datasets[] içerebilir.

Eğitilen bir modelin sonuçlarını geliştirmek için akustik veriler dil eğitimi sırasında dahili olarak otomatik olarak kullanılır. Genel olarak, v3 API'si aracılığıyla oluşturulan modeller, v2 API'si ile oluşturulan modellerden daha doğru sonuçlar sağlar.

Önemli

Hem akustik hem de dil modeli bölümünü özelleştirmek için POST'ta gerekli tüm dil ve akustik veri datasets[] kümelerini 'ye iletirsiniz. /speechtotext/v3.0/models Bu, her iki parçanın özelleştirilmiş olduğu tek bir model oluşturacak.

Temel ve özel modelleri alma

v3, kullanılabilir modellerin elde leştirilmesini basitleştirmek için "temel model" koleksiyonlarını müşteriye ait "özelleştirilmiş modellerden" ayırdı. İki yol şimdi ve GET /speechtotext/v3.0/models/base GET /speechtotext/v3.0/models/ olur.

v2'de tüm modeller tek bir yanıtla birlikte döndürüldü.

Önemli

Özelleştirme için sağlanan temel modellerin listesini almak için üzerinde GET /speechtotext/v3.0/models/base kullanın. Üzerinde bir ile kendi özelleştirilmiş modellerinizi GET /speechtotext/v3.0/models bulabilirsiniz.

Varlığın adı

özelliği name artık displayName olur. Bu, kimlik özelliklerini belirtmek için diğer Azure API'leriyle tutarlıdır. Bu özelliğin değeri benzersiz olmalıdır ve varlık oluşturma işlemiyle birlikte PATCH değiştirilebilir.

v2 transkripsiyonu:

{
    "name": "Transcription using locale en-US"
}

v3 transkripsiyonu:

{
    "displayName": "Transcription using locale en-US"
}

Önemli

İstemci kodunda name özelliğini displayName olarak yeniden adlandırabilirsiniz.

Başvurulan varlıklara erişme

v2'de, başvurulan varlıklar her zaman bir uç noktanın kullanılan modelleri gibi, her zaman çizgi içindedir. Varlıkların iç içe yerleştirmesi büyük yanıtlara neden oldu ve tüketiciler iç içe geçmiş içeriği nadiren tüketti. Yanıt boyutunu küçültmek ve performansı artırmak için, başvurulan varlıklar artık yanıtta genel olarak yer alinmemektedir. Bunun yerine, diğer varlığa bir başvuru görünür ve bağlantıyla aynı desene uygun olarak doğrudan bir sonraki (URL de) GET self için kullanılabilir.

v2 transkripsiyonu:

{
  "id": "9891c965-bb32-4880-b14b-6d44efb158f3",
  "models": [
    {
      "id": "827712a5-f942-4997-91c3-7c6cde35600b",
      "modelKind": "Language",
      "lastActionDateTime": "2019-01-07T11:36:07Z",
      "status": "Running",
      "createdDateTime": "2019-01-07T11:34:12Z",
      "locale": "en-US",
      "name": "Acoustic model",
      "description": "Example for an acoustic model",
      "datasets": [
        {
          "id": "702d913a-8ba6-4f66-ad5c-897400b081fb",
          "dataImportKind": "Language",
          "lastActionDateTime": "2019-01-07T11:36:07Z",
          "status": "Succeeded",
          "createdDateTime": "2019-01-07T11:34:12Z",
          "locale": "en-US",
          "name": "Language dataset",
        }
      ]
    },
  ]
}

v3 transkripsiyonu:

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/transcriptions/9891c965-bb32-4880-b14b-6d44efb158f3",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/models/021a72d0-54c4-43d3-8254-27336ead9037"
  }
}

Yukarıdaki örnekte gösterildiği gibi başvurulan bir modelin ayrıntılarını tüketmek için üzerinde bir GET göndermenız yeterli $.model.self olur.

Önemli

Başvurulan varlıkların meta verilerini almak için üzerinde bir GET(GET) kullanın; örneğin transkripsiyon $.{referencedEntity}.self modelini almak için üzerinde bir GET $.model.self yapar.

Uç nokta günlüklerini alma

Hizmetin sürüm v2' de uç nokta sonuçlarını günlüğe kaydetmeyi destekliyor. v2 ile bir uç noktanın sonuçlarını almak için, bir zaman aralığı tarafından tanımlanan sonuçların anlık görüntüsünü temsil eden bir "veri dışarı aktarma" oluşturmanız gerekir. Toplu verileri dışarı aktarma işlemi esnek değildir. v3 API'si her bir dosyaya erişim verir ve bu dosyalarda yinelemeye izin verir.

Başarılı bir şekilde çalışan v3 uç noktası:

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/endpoints/afa0669c-a01e-4693-ae3a-93baf40f26d6",
  "links": {
    "logs": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/endpoints/afa0669c-a01e-4693-ae3a-93baf40f26d6/files/logs" 
  }
}

GET $.links.logs yanıtı:

{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/endpoints/6d72ad7e-f286-4a6f-b81b-a0532ca6bcaa/files/logs/2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.wav",
      "name": "2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.wav",
      "kind": "Audio",
      "properties": {
        "size": 12345
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.wav?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=e05d8d56-9675-448b-820c-4318ae64c8d5"
      }
    }    
  ],
  "@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/endpoints/afa0669c-a01e-4693-ae3a-93baf40f26d6/files/logs?top=2&SkipToken=2!188!MDAwMDk1ITZhMjhiMDllLTg0MDYtNDViMi1hMGRkLWFlNzRlOGRhZWJkNi8yMDIwLTA0LTAxLzEyNDY0M182MzI5NGRkMi1mZGYzLTRhZmEtOTA0NC1mODU5ZTcxOWJiYzYud2F2ITAwMDAyOCE5OTk5LTEyLTMxVDIzOjU5OjU5Ljk5OTk5OTlaIQ--"
}

Uç nokta günlükleri için sayfalama diğer tüm koleksiyonlara benzer şekilde çalışır, ancak hiçbir uzaklık belirtilmez. Kullanılabilir veri miktarı çok fazla olduğu için sayfalama sunucu tarafından belirlenir.

v3'te her uç nokta günlüğü, bir dosyanın üzerinde bir işlem kullanılarak veya üzerinde DELETE self kullanılarak ayrı ayrı DELETE $.links.logs silinebilir. Bir bitiş tarihi belirtmek için sorgu endDate parametresi i isteğine eklenebilir.

Önemli

Günlük dosyalarına tek tek erişmek için /api/speechtotext/v2.0/endpoints/{id}/data günlük /v3.0/endpoints/{id}/files/logs/ dışarı aktarmaları oluşturmak yerine kullanın.

Özel özellikleri kullanma

Özel özellikleri isteğe bağlı yapılandırma özelliklerinden ayırmak için, açıkça adlandırılmış tüm özellikler artık özelliğinde bulunur ve çağıranlar tarafından tanımlanan tüm özellikler properties artık özelliğinde customProperties bulunur.

v2 transkripsiyon varlığı:

{
  "properties": {
    "customerDefinedKey": "value",
    "diarizationEnabled": "False",
    "wordLevelTimestampsEnabled": "False"
  }
}

v3 transkripsiyon varlığı:

{
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false 
  },
  "customProperties": {
    "customerDefinedKey": "value"
  }
}

Bu değişiklik, altındaki tüm açık olarak adlandırılmış özelliklerde (dize yerine boole gibi) properties doğru türleri kullanmana da olanak sağlar.

Önemli

Tüm özel özellikleri customProperties isteklerinize properties yerine olarak POST iletir.

Yanıt üst bilgileri

v3 artık Operation-Location isteklerde üst bilgiye ek Location olarak üst bilgi POST döndürmeyecek. v2'de her iki üst bilgi de aynıydı. Şimdi yalnızca Location döndürülür.

Yeni API sürümü artık Azure API management (APIM) tarafından yönetiliyor olduğundan azaltmayla ilgili üst bilgiler , ve yanıt üst X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset bilgisinde yer alamamıştır.

Önemli

yerine yanıt üst bilgisinde Location konumu Operation-Location okuyun. 429 yanıt kodunda , veya Retry-After yerine üst bilgi değerini X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset okuyun.

Doğruluk testleri

Doğruluk testleri değerlendirme olarak yeniden adlandırıldı çünkü yeni ad neyi temsil edeceklerini daha iyi açıklar. Yeni yollar: https://{region}.api.cognitive.microsoft.com/speechtotext/v3.0/evaluations .

Önemli

İstemci kodunda yol accuracytests evaluations kesimini olarak yeniden adlandırabilirsiniz.

Sonraki adımlar

Konuşma hizmetleri tarafından sağlanan bu yaygın olarak kullanılan REST API'lerinin tüm özelliklerini inceleme: