Konuşma hizmeti API'leri için Docker kapsayıcılarını yükleme ve çalıştırma

Kapsayıcıları kullanarak Azure Bilişsel Hizmetler Konuşma hizmeti API'lerinden bazılarını kendi ortamınızda çalıştırabilirsiniz. Kapsayıcılar, belirli güvenlik ve veri idare gereksinimleri için çok kullanışlıdır. Bu makalede Konuşma kapsayıcısını indirmeyi, yüklemeyi ve çalıştırmayı öğreneceksiniz.

Konuşma kapsayıcıları ile hem güçlü bulut özellikleri hem de uç yerelliği için iyileştirilmiş bir konuşma uygulaması mimarisi oluşturabilirsiniz. Bulut tabanlı Azure Konuşma hizmetleriyle aynı fiyatlandırmayı kullanan çeşitli kapsayıcılar mevcuttur.

Önemli

Standart konuşma sentezi seslerini ve metin okuma kapsayıcısını 31 Ağustos 2021'de kullanımdan kaldırdık. Bunun yerine nöral metin okuma kapsayıcısını kullanmak için uygulamalarınızı geçirmeyi göz önünde bulundurun. Uygulamanızı güncelleştirme hakkında daha fazla bilgi için bkz . Standart sesten önceden oluşturulmuş sinir sesine geçiş.

Kapsayıcı Özellikler En son Yayın durumu
Konuşmayı metne dönüştürme Yaklaşımı analiz eder ve ara sonuçlarla sürekli gerçek zamanlı konuşma veya toplu ses kayıtlarının dökümünü alır. 3.8.0 Genel kullanıma sunuldu
Özel konuşmayı metne dönüştürme Özel Konuşma portalından özel bir model kullanarak, sürekli gerçek zamanlı konuşma veya toplu ses kayıtlarını ara sonuçlarla metne ayırır. 3.8.0 Genel kullanıma sunuldu
Konuşma dili tanımlama Ses dosyalarında konuşulan dili algılar. 1.5.0 Önizleme
Nöral metin okuma Daha doğal sentezlenmiş konuşmayı sağlayan derin sinir ağı teknolojisini kullanarak metni doğal sesli konuşmaya dönüştürür. 2.7.0 Genel kullanıma sunuldu

Önkoşullar

Önemli

  • Konuşma kapsayıcılarını kullanmak için çevrimiçi bir istek göndermeniz ve bunu onaylamanız gerekir. Daha fazla bilgi için "Kapsayıcıyı çalıştırmak için onay isteme" bölümüne bakın.
  • Genel kullanıma sunulan kapsayıcılar Microsoft kararlılığını ve destek gereksinimlerini karşılar. Önizleme aşamasındaki kapsayıcılar hala geliştirme aşamasındadır.

Konuşma hizmeti kapsayıcılarını kullanmadan önce aşağıdaki önkoşulları karşılamanız gerekir. Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun. Gerekenler:

  • Docker bir ana bilgisayara yüklendi. Docker, kapsayıcıların Azure'a bağlanmasına ve faturalama verileri göndermesine izin verecek şekilde yapılandırılmalıdır.
    • Windows'da Docker,Linux kapsayıcılarını destekleyecek şekilde de yapılandırılmalıdır.
    • Docker kavramları hakkında temel bilgilere sahip olmanız gerekir.
  • Ücretsiz (F0) veya standart (S) fiyatlandırma katmanıylaKonuşma hizmeti kaynağı.

Gerekli parametreleri toplama

Tüm Bilişsel Hizmetler kapsayıcıları için üç birincil parametre gereklidir. Microsoft Yazılım Lisans Koşulları kabul değeriyle birlikte mevcut olmalıdır. Uç Nokta URI'si ve API anahtarı da gereklidir.

Uç nokta URI'si

Değer, {ENDPOINT_URI} ilgili Bilişsel Hizmetler kaynağının Azure portal Genel Bakış sayfasında bulunabilir. Genel Bakış sayfasına gidin, uç noktanın üzerine gelin ve Panoya kopyala simgesi görüntülenir. Gerektiğinde uç noktayı kopyalayın ve kullanın.

Daha sonra kullanmak üzere uç nokta URI'sini toplamayı gösteren ekran görüntüsü.

Anahtarlar

{API_KEY} Değer kapsayıcıyı başlatmak için kullanılır ve ilgili Bilişsel Hizmetler kaynağının Azure portal Anahtarlar sayfasında kullanılabilir. Anahtarlar sayfasına gidin ve Panoya kopyala simgesini seçin.

Daha sonra kullanmak üzere iki anahtardan birini almayı gösteren ekran görüntüsü.

Önemli

Bu abonelik anahtarları Bilişsel Hizmetler API'nize erişmek için kullanılır. Anahtarlarınızı paylaşmayın. Bunları güvenli bir şekilde depolayın. Örneğin Azure Key Vault kullanın. Ayrıca bu anahtarları düzenli olarak yeniden oluşturmanızı öneririz. API çağrısı yapmak için yalnızca bir anahtar gereklidir. İlk anahtarı yeniden oluştururken, hizmete sürekli erişim için ikinci anahtarı kullanabilirsiniz.

Konak bilgisayar gereksinimleri ve önerileri

Konak, Docker kapsayıcısını çalıştıran x64 tabanlı bir bilgisayardır. Şirket içi bir bilgisayar veya Azure'da Docker barındırma hizmeti olabilir, örneğin:

Kapsayıcı gereksinimleri ve önerileri

Aşağıdaki tabloda, her Konuşma kapsayıcısı için kaynakların en düşük ve önerilen ayırması açıklanmaktadır:

Kapsayıcı Minimum Önerilen
Konuşmayı metne dönüştürme 4 çekirdek, 4 GB bellek 8 çekirdek, 6 GB bellek
Özel konuşmayı metne dönüştürme 4 çekirdek, 4 GB bellek 8 çekirdek, 6 GB bellek
Konuşma dili tanımlama 1 çekirdek, 1 GB bellek 1 çekirdek, 1 GB bellek
Nöral metin okuma 6 çekirdek, 12 GB bellek 8 çekirdek, 16 GB bellek

Her çekirdek en az 2,6 gigahertz (GHz) veya daha hızlı olmalıdır.

Çekirdek ve bellek, komutun --cpus bir parçası olarak kullanılan ve --memory ayarlarına docker run karşılık gelir.

Not

Minimum ve önerilen ayırmalar konak makine kaynaklarına değil Docker sınırlarına bağlıdır. Örneğin, konuşmayı metne dönüştürme kapsayıcıları büyük bir dil modelinin bellek eşleme bölümlerini eşler. Dosyanın tamamının belleğe sığması önerilir ve bu da ek olarak 4 ile 6 GB'tır. Ayrıca, modeller belleğe çağrıldığından her iki kapsayıcının ilk çalıştırması daha uzun sürebilir.

Gelişmiş Vektör Uzantısı desteği

Konak, Docker kapsayıcısını çalıştıran bilgisayardır. Konağın Gelişmiş Vektör Uzantılarını (AVX2) desteklemesi gerekir. Aşağıdaki komutla Linux konaklarında AVX2 desteğini de kontrol edebilirsiniz:

grep -q avx2 /proc/cpuinfo && echo AVX2 supported || echo No AVX2 support detected

Uyarı

AvX2'yi desteklemek için ana bilgisayar gereklidir . Kapsayıcı, AVX2 desteği olmadan düzgün çalışmaz.

Kapsayıcıyı çalıştırmak için onay isteme

Kapsayıcıya erişim istemek için istek formunu doldurun ve gönderin.

Form, siz, şirketiniz ve kapsayıcıyı kullanacağınız kullanıcı senaryosu hakkında bilgi istemektedir. Formu gönderdikten sonra Azure Bilişsel Hizmetler ekibi formu inceler ve 10 iş günü içinde size bir karar e-posta ile gönderir.

Önemli

  • Formda, Azure abonelik kimliğiyle ilişkilendirilmiş bir e-posta adresi kullanmanız gerekir.
  • Kapsayıcıyı çalıştırmak için kullandığınız Azure kaynağının onaylı Azure abonelik kimliğiyle oluşturulmuş olması gerekir.
  • Microsoft uygulamanızın durumuyla ilgili güncelleştirmeler için e-postanızı (gelen kutusu ve gereksiz klasörler) denetleyin.

Onayladıktan sonra, kapsayıcıyı makalenin devamında açıklanan Microsoft Container Registry'den (MCR) indirdikten sonra çalıştırabilirsiniz.

Azure aboneliğiniz onaylanmamışsa kapsayıcıyı çalıştıramazsınız.

Docker pull ile kapsayıcı görüntüsünü alma

Konuşma için kapsayıcı görüntüleri aşağıdaki kapsayıcı kayıt defterinde kullanılabilir.

Kapsayıcı Depo
Konuşmayı metne dönüştürme mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:latest

İpucu

İndirilen kapsayıcı görüntülerinizi listelemek için docker images komutunu kullanabilirsiniz. Örneğin, aşağıdaki komut indirilen her kapsayıcı görüntüsünün kimliğini, deposunu ve etiketini tablo olarak biçimlendirilmiş olarak listeler:

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

Konuşma kapsayıcıları için Docker çekme

Konuşmayı metne dönüştürme kapsayıcısı için Docker çekme

kapsayıcı görüntüsünü Microsoft Container Registry'den indirmek için docker pull komutunu kullanın:

docker pull mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:latest

Önemli

latest etiketi yerel ayarı çekeren-US. Ek yerel ayarlar için bkz. Konuşmayı metne dönüştürme yerel ayarları.

Konuşmayı metne dönüştürme yerel ayarları

dışındaki latesttüm etiketler aşağıdaki biçimdedir ve büyük/küçük harfe duyarlıdır:

<major>.<minor>.<patch>-<platform>-<locale>-<prerelease>

Aşağıdaki etiket, biçimin bir örneğidir:

2.6.0-amd64-en-us

Konuşmayı metne dönüştürme kapsayıcısının desteklenen tüm yerel ayarları için bkz. Konuşmayı metne dönüştürme resim etiketleri.

Kapsayıcıyı kullanma

Kapsayıcı konak bilgisayarda olduktan sonra, kapsayıcıyla çalışmak için aşağıdaki işlemi kullanın.

  1. Kapsayıcıyı gerekli faturalama ayarlarıyla çalıştırın. Komutun docker run daha fazla örneği mevcuttur.
  2. Kapsayıcının tahmin uç noktasını sorgula.

Kapsayıcıyı docker run ile çalıştırma

Kapsayıcıyı çalıştırmak için docker run komutunu kullanın. ve değerlerini alma {Endpoint_URI} hakkında daha fazla bilgi için bkz. Gerekli parametreleri toplama.{API_Key} Komutun docker run diğer örnekleri de mevcuttur.

Kapsayıcıyı bağlantısız ortamlarda çalıştırma

İnternet bağlantısı kesilmiş kapsayıcıları kullanmak için erişim istemeniz gerekir. Daha fazla bilgi için bkz. Bağlantısız ortamlarda kapsayıcıları kullanmak için erişim isteme.

Not

Genel kapsayıcı gereksinimleri için bkz. Kapsayıcı gereksinimleri ve önerileri.

Standart konuşmayı metne dönüştürme kapsayıcısını çalıştırmak için aşağıdaki docker run komutu yürütür:

docker run --rm -it -p 5000:5000 --memory 4g --cpus 4 \
mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Şu komut:

  • Kapsayıcı görüntüsünden konuşmayı metne dönüştürme kapsayıcısını çalıştırır.
  • 4 CPU çekirdeği ve 4 GB bellek ayırır.
  • TCP bağlantı noktası 5000'i kullanıma sunar ve kapsayıcı için sahte bir TTY ayırır.
  • Kapsayıcı çıktıktan sonra otomatik olarak kaldırılır. Kapsayıcı görüntüsü ana bilgisayarda hala kullanılabilir.

Not

Kapsayıcılar, GStreamer kullanarak Konuşma SDK'sına sıkıştırılmış ses girişini destekler. GStreamer'ı bir kapsayıcıya yüklemek için Konuşma SDK'sı ile codec sıkıştırılmış ses girişini kullanma başlığı altındaki GStreamer için Linux yönergelerini izleyin.

Konuşmayı metne dönüştürme çıkışında kesinleştirme

Kesinleştirme varsayılan olarak etkindir. Yanıtınızda kesinleştirme almak için kullanın diarize_speech_config.set_service_property.

  1. Tümcecik çıkış biçimini olarak Detailedayarlayın.

  2. Gündağıtma modunu ayarlayın. Desteklenen modlar ve AnonymousşeklindedirIdentity.

    diarize_speech_config.set_service_property(
        name='speechcontext-PhraseOutput.Format',
        value='Detailed',
        channel=speechsdk.ServicePropertyChannel.UriQueryParameter
    )
    
    diarize_speech_config.set_service_property(
        name='speechcontext-phraseDetection.speakerDiarization.mode',
        value='Identity',
        channel=speechsdk.ServicePropertyChannel.UriQueryParameter
    )
    

    Not

    "Kimlik" modu veya "SpeakerId": "Agent"döndürür"SpeakerId": "Customer". "Anonim" modu veya "SpeakerId": "Speaker 2"döndürür"SpeakerId": "Speaker 1".

Konuşmayı metne dönüştürme çıkışındaki yaklaşımı analiz etme

Konuşmayı metne dönüştürme kapsayıcısının v2.6.0 sürümünden başlayarak önizleme yerine Language service 3.0 API uç noktasını kullanmanız gerekir. Örnek:

  • https://eastus.api.cognitive.microsoft.com/text/analytics/v3.0/sentiment
  • https://localhost:5000/text/analytics/v3.0/sentiment

Not

Dil hizmeti v3.0 API'si ile v3.0-preview.1geriye dönük olarak uyumlu değildir. En son yaklaşım özelliği desteğini almak için konuşmayı metne dönüştürme kapsayıcı görüntüsünü ve Dil hizmetini v3.0kullanınv2.6.0.

Konuşmayı metne dönüştürme kapsayıcısının v2.2.0'dan başlayarak çıkışta yaklaşım analizi v3 API'sini çağırabilirsiniz. Yaklaşım analizini çağırmak için bir Dil hizmeti API'si kaynak uç noktası gerekir. Örnek:

  • https://eastus.api.cognitive.microsoft.com/text/analytics/v3.0-preview.1/sentiment
  • https://localhost:5000/text/analytics/v3.0-preview.1/sentiment

Bulutta bir Dil hizmeti uç noktasına erişiyorsanız bir anahtara ihtiyacınız olacaktır. Dil hizmeti özelliklerini yerel olarak çalıştırıyorsanız, bunu sağlamanız gerekmeyebilir.

Anahtar ve uç nokta, aşağıdaki örnekte olduğu gibi Konuşma kapsayıcısına bağımsız değişken olarak geçirilir:

docker run -it --rm -p 5000:5000 \
mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:latest \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY} \
CloudAI:SentimentAnalysisSettings:TextAnalyticsHost={TEXT_ANALYTICS_HOST} \
CloudAI:SentimentAnalysisSettings:SentimentAnalysisApiKey={SENTIMENT_APIKEY}

Şu komut:

  • Önceki komutla aynı adımları gerçekleştirir.
  • Yaklaşım analizi istekleri göndermek için bir Dil hizmeti API'si uç noktasını ve anahtarını depolar.

Konuşmayı metne dönüştürme çıkışında Phraselist v2

Konuşmayı metne dönüştürme kapsayıcısının v2.6.0'dan başlayarak, çıkışı tam tümcecik veya ortadaki tümcecikler olmak üzere kendi tümceciklerinizle alabilirsiniz. Örneğin, şu cümledeki uzun adam :

  • "Bu bir cümle, uzun boylu adam bu da başka bir cümle."

Tümcecik listesini yapılandırmak için, aramayı yaparken kendi tümceciklerinizi eklemeniz gerekir. Örnek:

    phrase="the tall man"
    recognizer = speechsdk.SpeechRecognizer(
        speech_config=dict_speech_config,
        audio_config=audio_config)
    phrase_list_grammer = speechsdk.PhraseListGrammar.from_recognizer(recognizer)
    phrase_list_grammer.addPhrase(phrase)
    
    dict_speech_config.set_service_property(
        name='setflight',
        value='xonlineinterp',
        channel=speechsdk.ServicePropertyChannel.UriQueryParameter
    )

Eklenecek birden çok tümcecik varsa, tümcecik listesine eklemek için her tümceciği çağırın .addPhrase() .

Önemli

Kapsayıcıyı Eulaçalıştırmak için , Billingve ApiKey seçenekleri belirtilmelidir. Aksi takdirde kapsayıcı başlatılmaz. Daha fazla bilgi için bkz . Faturalama.

Kapsayıcının tahmin uç noktasını sorgulama

Not

Birden çok kapsayıcı çalıştırıyorsanız benzersiz bir bağlantı noktası numarası kullanın.

Kapsayıcılar SDK Ana Bilgisayar URL'si Protokol
Standart konuşmayı metne dönüştürme ve özel konuşmayı metne dönüştürme ws://localhost:5000 WS
Nöral Metin Okuma, Konuşma dili tanımlama http://localhost:5000 HTTP

WSS ve HTTPS protokollerini kullanma hakkında daha fazla bilgi için bkz. Kapsayıcı güvenliği.

Konuşmayı metne dönüştürme (standart ve özel)

Kapsayıcı, Konuşma SDK'sı aracılığıyla erişilen websocket tabanlı sorgu uç noktası API'leri sağlar. Konuşma SDK'sı varsayılan olarak çevrimiçi konuşma hizmetlerini kullanır. Kapsayıcıyı kullanmak için başlatma yöntemini değiştirmeniz gerekir.

İpucu

Konuşma SDK'sını kapsayıcılarla kullandığınızda, Azure Konuşma kaynağı abonelik anahtarını veya kimlik doğrulama taşıyıcı belirtecini sağlamanız gerekmez.

Aşağıdaki örneklere bakın.

Bu Azure bulut başlatma çağrısını kullanmaktan değiştirin:

var config = SpeechConfig.FromSubscription("YourSubscriptionKey", "YourServiceRegion");

Bu çağrıyı kapsayıcı konağıyla kullanmak için:

var config = SpeechConfig.FromHost(
    new Uri("ws://localhost:5000"));

Yaklaşımı analiz etme

Kapsayıcıya Dil hizmeti API'sinin kimlik bilgilerini sağladıysanız konuşma tanıma isteklerini yaklaşım analiziyle göndermek için Konuşma SDK'sını kullanabilirsiniz. API yanıtlarını basit veya ayrıntılı bir biçim kullanacak şekilde yapılandırabilirsiniz.

Not

Konuşma Tanıma Hizmeti Python SDK'sının v1.13'ünün yaklaşım analiziyle ilgili tanımlanmış bir sorunu vardır. Konuşma Tanıma Hizmeti Python SDK'sında yaklaşım analizi kullanıyorsanız v1.12.x veya önceki bir sürümünü kullanın.

Konuşma istemcisini basit bir biçim kullanacak şekilde yapılandırmak için Simple.Extensionsdeğeri olarak ekleyin"Sentiment". Belirli bir Dil hizmeti modeli sürümü seçmek istiyorsanız, özellik yapılandırmasında speechcontext-phraseDetection.sentimentAnalysis.modelversion değerini değiştirin'latest'.

speech_config.set_service_property(
    name='speechcontext-PhraseOutput.Simple.Extensions',
    value='["Sentiment"]',
    channel=speechsdk.ServicePropertyChannel.UriQueryParameter
)
speech_config.set_service_property(
    name='speechcontext-phraseDetection.sentimentAnalysis.modelversion',
    value='latest',
    channel=speechsdk.ServicePropertyChannel.UriQueryParameter
)

Simple.Extensions yanıtın kök katmanında yaklaşım sonucunu döndürür.

{
   "DisplayText":"What's the weather like?",
   "Duration":13000000,
   "Id":"6098574b79434bd4849fee7e0a50f22e",
   "Offset":4700000,
   "RecognitionStatus":"Success",
   "Sentiment":{
      "Negative":0.03,
      "Neutral":0.79,
      "Positive":0.18
   }
}

Yaklaşım analizini tamamen devre dışı bırakmak istiyorsanız öğesine bir false değer sentimentanalysis.enabledekleyin.

speech_config.set_service_property(
    name='speechcontext-phraseDetection.sentimentanalysis.enabled',
    value='false',
    channel=speechsdk.ServicePropertyChannel.UriQueryParameter
)

Nöral Metin Okuma

Kapsayıcı REST tabanlı uç nokta API'leri sağlar. Platform, çerçeve ve dil çeşitlemeleri için birçok örnek kaynak kodu projesi mevcuttur.

Nöral Metin Okuma kapsayıcıları ile indirdiğiniz görüntü etiketinin yerel ayarına ve sesine güvenmelisiniz. Örneğin, etiketi indirdiyseniz latest varsayılan yerel ayar ve AriaNeural sestiren-US. Bağımsız {VOICE_NAME} değişken daha sonra olur en-US-AriaNeural. Aşağıdaki örnek SSML'ye bakın:

<speak version="1.0" xml:lang="en-US">
    <voice name="en-US-AriaNeural">
        This text will get converted into synthesized speech.
    </voice>
</speak>

Aynı konakta birden çok kapsayıcı çalıştırma

Kullanıma sunulan bağlantı noktalarıyla birden çok kapsayıcı çalıştırmak istiyorsanız, her kapsayıcıyı farklı bir kullanıma sunulan bağlantı noktasıyla çalıştırdığınızdan emin olun. Örneğin, ilk kapsayıcıyı 5000 numaralı bağlantı noktasında, ikinci kapsayıcıyı da 5001 numaralı bağlantı noktasında çalıştırın.

Bu kapsayıcıyı ve HOST üzerinde çalışan farklı bir Bilişsel Hizmetler kapsayıcısını birlikte kullanabilirsiniz. Aynı Bilişsel Hizmetler kapsayıcısının birden çok kapsayıcısını da çalıştırabilirsiniz.

Kapsayıcının çalıştığını doğrulama

Kapsayıcının çalıştığını doğrulamanın çeşitli yolları vardır. Söz konusu kapsayıcının Dış IP adresini ve kullanıma sunulan bağlantı noktasını bulun ve sık kullandığınız web tarayıcısını açın. Kapsayıcının çalıştığını doğrulamak için aşağıdaki çeşitli istek URL'lerini kullanın. Burada listelenen örnek istek URL'leri şeklindedir http://localhost:5000, ancak kapsayıcınız farklılık gösterebilir. Kapsayıcınızın Dış IP adresine ve kullanıma sunulan bağlantı noktasına bağlı olduğundan emin olun.

İstek URL’si Amaç
http://localhost:5000/ Kapsayıcı bir giriş sayfası sağlar.
http://localhost:5000/ready GET ile istenen bu URL, kapsayıcının modele yönelik bir sorguyu kabul etmeye hazır olduğuna ilişkin bir doğrulama sağlar. Bu istek Kubernetes canlılığı ve hazırlık yoklamaları için kullanılabilir.
http://localhost:5000/status Get ile de istenen bu URL, kapsayıcıyı başlatmak için kullanılan api anahtarının bir uç nokta sorgusuna neden olmadan geçerli olup olmadığını doğrular. Bu istek Kubernetes canlılığı ve hazırlık yoklamaları için kullanılabilir.
http://localhost:5000/swagger Kapsayıcı uç noktalar için tüm belgeleri ve bir de Deneyin özelliği sağlar. Bu özellik sayesinde, ayarlarınızı web tabanlı bir HTML formuna girebilir ve herhangi bir kod yazmak zorunda kalmadan sorguyu yapabilirsiniz. Sorgu döndükten sonra, gerekli HTTP üst bilgilerini ve gövde biçimini göstermek için örnek bir CURL komutu sağlanır.

Kapsayıcının giriş sayfası

Kapsayıcıyı durdurma

Kapsayıcıyı kapatmak için, kapsayıcının çalıştığı komut satırı ortamında Ctrl+C tuşlarını seçin.

Sorun giderme

Kapsayıcıyı başlattığınızda veya çalıştırdığınızda sorunlarla karşılaşabilirsiniz. Bir çıkış bağlaması kullanın ve günlüğü etkinleştirin. Bunun yapılması, kapsayıcının sorunları giderirken yararlı olan günlük dosyaları oluşturmasına olanak tanır.

İpucu

Daha fazla sorun giderme bilgisi ve rehberlik için bkz. Bilişsel Hizmetler kapsayıcıları hakkında sık sorulan sorular (SSS).

Bilişsel Hizmetler kapsayıcısını çalıştırırken sorun yaşıyorsanız Microsoft tanılama kapsayıcısını kullanmayı deneyebilirsiniz. Dağıtım ortamınızda Bilişsel Hizmetler kapsayıcılarının beklendiği gibi çalışmasını engelleyebilecek yaygın hataları tanılamak için bu kapsayıcıyı kullanın.

Kapsayıcıyı almak için aşağıdaki docker pull komutu kullanın:

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

Ardından kapsayıcıyı çalıştırın. değerini {ENDPOINT_URI} uç noktanızla değiştirin ve değerini kaynağınızın anahtarıyla değiştirin {API_KEY} :

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Kapsayıcı, faturalama uç noktasına ağ bağlantısını test eder.

Faturalandırma

Konuşma kapsayıcıları, Azure hesabınızdaki konuşma kaynağını kullanarak faturalama bilgilerini Azure'a gönderir.

Kapsayıcıya yönelik sorgular, parametresi için kullanılan Azure kaynağının fiyatlandırma katmanında ApiKey faturalandırılır.

Azure Bilişsel Hizmetler kapsayıcıları, ölçüm veya faturalama uç noktasına bağlanmadan çalıştırılmak üzere lisanslanmaz. Kapsayıcıların faturalama bilgilerini faturalama uç noktasıyla her zaman iletmesini etkinleştirmeniz gerekir. Bilişsel Hizmetler kapsayıcıları analiz edilen görüntü veya metin gibi müşteri verilerini Microsoft göndermez.

Azure'a Bağlanma

Kapsayıcının çalışması için faturalama bağımsız değişkeni değerleri gerekir. Bu değerler kapsayıcının faturalama uç noktasına bağlanmasına olanak sağlar. Kapsayıcı yaklaşık 10-15 dakikada bir kullanımı bildirir. Kapsayıcı izin verilen zaman penceresi içinde Azure'a bağlanmazsa, kapsayıcı çalışmaya devam eder ancak faturalama uç noktası geri yüklenene kadar sorgu sunmaz. Bağlantı 10 ile 15 dakika aynı zaman aralığında 10 kez denenir. 10 denemede faturalama uç noktasına bağlanamazsa kapsayıcı isteklerin sunulmasını durdurur. Faturalama için Microsoft gönderilen bilgilerin bir örneği için Bkz. Bilişsel Hizmetler kapsayıcısı hakkında SSS.

Faturalama bağımsız değişkenleri

Aşağıdaki docker run seçeneklerin üçü de geçerli değerlerle sağlandığında komut kapsayıcıyı başlatır:

Seçenek Açıklama
ApiKey Faturalama bilgilerini izlemek için kullanılan Bilişsel Hizmetler kaynağının API anahtarı.
Bu seçeneğin değeri, içinde Billingbelirtilen sağlanan kaynak için bir API anahtarına ayarlanmalıdır.
Billing Faturalama bilgilerini izlemek için kullanılan Bilişsel Hizmetler kaynağının uç noktası.
Bu seçeneğin değeri, sağlanan bir Azure kaynağının uç nokta URI'sine ayarlanmalıdır.
Eula Kapsayıcının lisansını kabul ettiğinizi gösterir.
Bu seçeneğin değeri kabul edilecek şekilde ayarlanmalıdır.

Bu seçenekler hakkında daha fazla bilgi için bkz. Kapsayıcıları yapılandırma.

Özet

Bu makalede Konuşma kapsayıcılarını indirme, yükleme ve çalıştırma kavramlarını ve iş akışını öğrendiniz. Özet:

  • Konuşma, Docker için çeşitli özelliklere sahip dört Linux kapsayıcısı sağlar:
    • Konuşmayı metne dönüştürme
    • Özel konuşmayı metne dönüştürme
    • Nöral metin okuma
    • Konuşma dili tanımlama
  • Kapsayıcı görüntüleri Azure'daki kapsayıcı kayıt defterinden indirilir.
  • Kapsayıcı görüntüleri Docker'da çalışır.
  • REST API (yalnızca metin okuma) veya SDK (konuşmayı metne dönüştürme veya metin okuma) kullansanız da kapsayıcının konak URI'sini belirtirsiniz.
  • Kapsayıcı örneği oluştururken faturalama bilgilerini sağlamanız gerekir.

Önemli

Bilişsel Hizmetler kapsayıcıları, ölçüm için Azure'a bağlanmadan çalıştırılma lisansına sahip değildir. Müşterilerin, kapsayıcıların faturalama bilgilerini ölçüm hizmetiyle her zaman iletmesini sağlaması gerekir. Bilişsel Hizmetler kapsayıcıları müşteri verilerini (örneğin, analiz edilen görüntü veya metin) Microsoft göndermez.

Sonraki adımlar