Konuşma hizmeti kapsayıcılarını yükleyip çalıştırmaInstall and run Speech Service containers

Konuşma kapsayıcıları, müşterilerin hem güçlü bulut özellikleri hem de kenar yerinin avantajlarından yararlanmak için optimize edilmiş bir konuşma uygulaması mimarisi oluşturmasına imkan tanır.Speech containers enable customers to build one speech application architecture that is optimized to take advantage of both robust cloud capabilities and edge locality.

İki konuşma kapsayıcısı konuşmadan metne ve metinden konuşmaya.The two speech containers are speech-to-text and text-to-speech.

İşlevFunction ÖzelliklerFeatures sürümüLatest
Konuşmayı Metne DönüştürmeSpeech-to-text
  • Sürekli gerçek zamanlı konuşmayı veya toplu ses kayıtlarını, ara sonuçlarla metin içine ekleyin.Transcribes continuous real-time speech or batch audio recordings into text with intermediate results.
  • 1.1.31.1.3
    Metin OkumaText-to-Speech
  • Metni, doğal sesli konuşmaya dönüştürür.Converts text to natural-sounding speech. düz metin girişi veya konuşma sen, biçimlendirme dili (SSML) ile.with plain text input or Speech Synthesis Markup Language (SSML).
  • 1.1.01.1.0

    Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.If you don't have an Azure subscription, create a free account before you begin.

    ÖnkoşullarPrerequisites

    Konuşma kapsayıcılarını kullanmadan önce aşağıdaki önkoşulları karşılamanız gerekir:You must meet the following prerequisites before using Speech containers:

    GerekliRequired AmaçPurpose
    Docker altyapısıDocker Engine Bir ana bilgisayardaDocker altyapısının yüklü olması gerekir.You need the Docker Engine installed on a host computer. Docker, MacOS, Windowsve Linux'ta Docker ortamını yapılandıran paketler sağlar.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. Docker ve kapsayıcı temelleri hakkında bilgi için bkz: Docker'a genel bakış.For a primer on Docker and container basics, see the Docker overview.

    Docker, kapsayıcılar ile bağlanma ve faturalama verileri Azure'a göndermek izin verecek şekilde yapılandırılmalıdır.Docker must be configured to allow the containers to connect with and send billing data to Azure.

    Windows 'daDocker 'ın de Linux kapsayıcılarını destekleyecek şekilde yapılandırılması gerekir.On Windows, Docker must also be configured to support Linux containers.

    Docker ile benzerlikFamiliarity with Docker Kayıt defterleri, depolar, kapsayıcılar ve kapsayıcı görüntüleri gibi Docker kavramlarının yanı sıra temel docker komutlar hakkında bilgi sahibi olmanız gerekir.You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.
    Konuşma kaynağıSpeech resource Bu kapsayıcıları kullanabilmeniz için, şunları yapmanız gerekir:In order to use these containers, you must have:

    İlişkili API anahtarını ve uç nokta URI 'sini almak için bir Azure konuşma kaynağı.An Azure Speech resource to get the associated API key and endpoint URI. Her iki değer de Azure portal konuşmaya genel bakış ve anahtarlar sayfalarında kullanılabilir.Both values are available on the Azure portal's Speech Overview and Keys pages. Kapsayıcının başlatılması için her ikisi de gereklidir.They are both required to start the container.

    {API_KEY} : Anahtarlar sayfasındaki kullanılabilir iki kaynak anahtardan biri{API_KEY}: One of the two available resource keys on the Keys page

    {ENDPOINT_URI} : Genel bakış sayfasında belirtilen bitiş noktası{ENDPOINT_URI}: The endpoint as provided on the Overview page

    Kapsayıcı kayıt defterine erişim istemeRequest access to the container registry

    Kapsayıcıya erişim istemek için önce bilişsel Hizmetler konuşma kapsayıcıları istek formunu doldurmanız ve göndermeniz gerekir.You must first complete and submit the Cognitive Services Speech Containers Request form to request access to the container.

    Form, şirketiniz ve kapsayıcı kullanacağınız kullanıcı senaryosu hakkında bilgi ister.The form requests information about you, your company, and the user scenario for which you'll use the container. Azure Bilişsel hizmetler takım formu gönderdikten sonra özel kapsayıcı kayıt defterine erişim için ölçütleri karşıladığından emin olmak üzere inceler.After you've submitted the form, the Azure Cognitive Services team reviews it to ensure that you meet the criteria for access to the private container registry.

    Önemli

    Formu bir Microsoft hesabı (MSA) veya Azure Active Directory (Azure AD) hesabı ile ilişkili bir e-posta adresi kullanmanız gerekir.You must use an email address that's associated with either a Microsoft Account (MSA) or Azure Active Directory (Azure AD) account in the form.

    İsteğiniz onaylandığında, kimlik bilgilerinizi edinme ve özel kapsayıcı kayıt defterine erişim açıklayan yönergeler içeren bir e-posta alacaksınız.If your request is approved, you'll receive an email with instructions that describe how to obtain your credentials and access the private container registry.

    Özel kapsayıcı kayıt defteri kimlik doğrulaması için Docker CLI'yı kullanınUse the Docker CLI to authenticate the private container registry

    Bilişsel hizmetler kapsayıcılarla birkaç şekilde özel kapsayıcı kayıt defteri ile doğrulayabilir, ancak önerilen yöntem komut satırından Docker CLI.You can authenticate with the private container registry for Cognitive Services Containers in any of several ways, but the recommended method from the command line is to use the Docker CLI.

    Kullanım docker login komutoturum açmak için aşağıdaki örnekte gösterildiği gibi containerpreview.azurecr.io, Bilişsel hizmetler kapsayıcılar için özel kapsayıcı kayıt defteri.Use the docker login command, as shown in the following example, to log in to containerpreview.azurecr.io, the private container registry for Cognitive Services Containers. Değiştirin <kullanıcıadı> kullanıcı adıyla ve <parola> kimlik bilgilerinde aldığınız sağlanan parola Azure Bilişsel hizmetler ekibi.Replace <username> with the user name and <password> with the password that's provided in the credentials you received from the Azure Cognitive Services team.

    docker login containerpreview.azurecr.io -u <username> -p <password>
    

    Bir metin dosyasındaki kimlik bilgilerinizi güvenli hale getirdiniz ise, metin dosyasının içeriğini kullanarak bitiştirebilirsiniz cat komutu için docker login , aşağıdaki örnekte gösterildiği gibi komutu.If you've secured your credentials in a text file, you can concatenate the contents of that text file, by using the cat command, to the docker login command, as shown in the following example. Değiştirin <passwordFile> ile parolasını içeren bir metin dosyasının adını ve yolunu ve <kullanıcıadı> kullanıcı adı kimlik bilgilerinizi sağlanır.Replace <passwordFile> with the path and name of the text file that contains the password and <username> with the user name that's provided in your credentials.

    cat <passwordFile> | docker login containerpreview.azurecr.io -u <username> --password-stdin
    

    Ana bilgisayarThe host computer

    Konak, Docker kapsayıcısı çalıştıran bir x64 tabanlı bir bilgisayardır.The host is a x64-based computer that runs the Docker container. Bir bilgisayarda şirket içinde veya azure'da Docker barındırma hizmeti gibi olabilir:It can be a computer on your premises or a Docker hosting service in Azure, such as:

    Gelişmiş vektör uzantısı desteğiAdvanced Vector Extension support

    Konak , Docker kapsayıcısını çalıştıran bilgisayardır.The host is the computer that runs the docker container. Ana bilgisayar Gelişmiş vektör uzantılarını desteklemelidir (AVX2).The host must support Advanced Vector Extensions (AVX2). Bu desteği Linux konaklarında aşağıdaki komutla kontrol edebilirsiniz:You can check this support on Linux hosts with the following command:

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

    Kapsayıcı gereksinimleri ve önerileriContainer requirements and recommendations

    Aşağıdaki tabloda, her bir konuşma kapsayıcısı için ayrılacak minimum ve önerilen CPU çekirdekleri ve bellek açıklanmaktadır.The following table describes the minimum and recommended CPU cores and memory to allocate for each Speech container.

    KapsayıcıContainer MinimumMinimum ÖnerilenRecommended
    bilişsel hizmetler-konuşmayı metne dönüştürmecognitive-services-speech-to-text 2 çekirdek2 core
    2 GB bellek2-GB memory
    4 çekirdek4 core
    4 GB bellek4-GB memory
    bilişsel hizmetler-metinden konuşmayacognitive-services-text-to-speech 1 çekirdek, 0,5 GB bellek1 core, 0.5-GB memory 2 çekirdek, 1 GB bellek2 core, 1-GB memory
    • Her çekirdek en az 2,6 gigahertz (GHz) veya daha hızlı olmalıdır.Each core must be at least 2.6 gigahertz (GHz) or faster.

    Çekirdek ve bellek, --cpus docker run komutunun bir parçası --memory olarak kullanılan ve ayarlarına karşılık gelir.Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

    Note; En düşük ve önerilen, ana makine kaynaklarından değil , Docker sınırlarına dayanır.Note; The minimum and recommended are based off of Docker limits, not the host machine resources. Örneğin, konuşmadan metne kapsayıcı bellek eşleme, büyük bir dil modelinin bölümlerine eşlenir ve tüm dosyanın belleğe sığması önerilir , bu da ek 4-6 GB 'tır.For example, speech-to-text containers memory map portions of a large language model, and it is recommended that the entire file fits in memory, which is an additional 4-6 GB. Ayrıca, modellerin bellekte sayfalandığından kapsayıcının ilk çalışması daha uzun sürebilir.Also, the first run of either container may take longer, since models are being paged into memory.

    Kapsayıcı görüntüsünü aldocker pullGet the container image with docker pull

    Konuşma için kapsayıcı görüntüleri kullanılabilir.Container images for Speech are available.

    KapsayıcıContainer HavuzRepository
    bilişsel hizmetler-konuşmayı metne dönüştürmecognitive-services-speech-to-text containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text:latest
    bilişsel hizmetler-metinden konuşmayacognitive-services-text-to-speech containerpreview.azurecr.io/microsoft/cognitive-services-text-to-speech:latest

    İpucu

    Kullanabileceğiniz docker görüntüleri indirilen kapsayıcı görüntülerinizi listelemek için komutu.You can use the docker images command to list your downloaded container images. Örneğin, aşağıdaki komut kimliği, havuz ve tablo olarak biçimlendirilmiş her indirilen kapsayıcı görüntüsünün etiketi listeler:For example, the following command lists the ID, repository, and tag of each downloaded container image, formatted as a table:

    docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"
    
    IMAGE ID            REPOSITORY              TAG
    <image-id>       <repository-path/name>         <tag-name>
    

    Dil yerel ayarı kapsayıcı etiketindeLanguage locale is in container tag

    Etiket, en-us yerel ayarı ve jessarus sesi çeker. latestThe latest tag pulls the en-us locale and jessarus voice.

    Konuşmayı metin yerel ayarlarına dönüştürmeSpeech to text locales

    Dışındaki latest tüm Etiketler, yerel ayar kapsayıcısını <culture> gösterdiği şekilde aşağıdaki biçimdedir:All tags, except for latest are in the following format, where the <culture> indicates the locale container:

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

    Aşağıdaki etiket, biçiminin bir örneğidir:The following tag is an example of the format:

    1.1.3-amd64-en-us-preview
    

    Aşağıdaki tabloda, kapsayıcının 1.1.3 sürümünde konuşmayı metne yönelik desteklenen yerel ayarlar listelenmiştir:The following table lists the supported locales for speech-to-text in the 1.1.3 version of the container:

    Dil yerel ayarıLanguage locale TagsTags
    ÇinceChinese zh-cn
    TürkçeEnglish en-us
    en-gb
    en-au
    en-in
    FransızcaFrench fr-ca
    fr-fr
    AlmancaGerman de-de
    İtalyancaItalian it-it
    JaponcaJapanese ja-jp
    KoreceKorean ko-kr
    PortekizcePortuguese pt-br
    İspanyolcaSpanish es-es
    es-mx

    Metinden konuşmaya yerel ayarlarıText to speech locales

    Dışındaki latest tüm Etiketler aşağıdaki biçimdedir; <culture> burada, yerel ayarı <voice> gösterir ve kapsayıcının sesini gösterir:All tags, except for latest are in the following format, where the <culture> indicates the locale and the <voice> indicates the voice of the container:

    <major>.<minor>.<patch>-<platform>-<culture>-<voice>-<prerelease>
    

    Aşağıdaki etiket, biçiminin bir örneğidir:The following tag is an example of the format:

    1.1.0-amd64-en-us-jessarus-preview
    

    Aşağıdaki tabloda, kapsayıcının 1.1.0 sürümünde metinden konuşmaya için desteklenen yerel ayarlar listelenmektedir:The following table lists the supported locales for text-to-speech in the 1.1.0 version of the container:

    Dil yerel ayarıLanguage locale TagsTags Desteklenen seslerSupported voices
    ÇinceChinese zh-cn kuihuırushuihuirus
    kangkang-Apollokangkang-apollo
    yaoyao-Apolloyaoyao-apollo
    TürkçeEnglish en-au Catherinecatherine
    hayleyrushayleyrus
    TürkçeEnglish en-gb George-Apollogeorge-apollo
    hazelrushazelrus
    çiğdem-Apollosusan-apollo
    TürkçeEnglish en-in Heera-Apolloheera-apollo
    Primuspriyarus
    rampadili-Apolloravi-apollo
    TürkçeEnglish en-us jessarusjessarus
    benjaminrusbenjaminrus
    jessa24krusjessa24krus
    ziraruszirarus
    guy24krusguy24krus
    FransızcaFrench fr-ca Caroline dilicaroline
    HARMİ Erusharmonierus
    FransızcaFrench fr-fr hortenserushortenserus
    Julie-Apollojulie-apollo
    Paul-Apollopaul-apollo
    AlmancaGerman de-de Heddahedda
    heddarusheddarus
    Stefan-Apollostefan-apollo
    İtalyancaItalian it-it cosımo-Apollocosimo-apollo
    luciarusluciarus
    JaponcaJapanese ja-jp Ayumi-Apolloayumi-apollo
    harukarusharukarus
    Ichiro-Apolloichiro-apollo
    KoreceKorean ko-kr heamirusheamirus
    PortekizcePortuguese pt-br Daniel-Apollodaniel-apollo
    heloisarusheloisarus
    İspanyolcaSpanish es-es elenaruselenarus
    gamze-Apollolaura-apollo
    Pablo-Apollopablo-apollo
    İspanyolcaSpanish es-mx tepdarushildarus
    vaul-Apolloraul-apollo

    Konuşma kapsayıcıları için Docker çekmeDocker pull for the speech containers

    Konuşmayı Metne DönüştürmeSpeech-to-text

    docker pull containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text:latest
    

    Metin okumaText-to-speech

    docker pull containerpreview.azurecr.io/microsoft/cognitive-services-text-to-speech:latest
    

    Kapsayıcıyı kullanmaHow to use the container

    Kapsayıcı ana bilgisayardanolduktan sonra, kapsayıcında çalışmak için aşağıdaki işlemi kullanın.Once the container is on the host computer, use the following process to work with the container.

    1. Kapsayıcıyıgereken ancak kullanılmayan faturalandırma ayarlarıyla çalıştırın.Run the container, with the required but not used billing settings. docker run Komuta daha fazla örnek kullanılabilir.More examples of the docker run command are available.
    2. Kapsayıcının tahmin uç noktasını sorgulayın.Query the container's prediction endpoint.

    Kapsayıcıyı ile çalıştırmadocker runRun the container with docker run

    Üç kapsayıcının herhangi birini çalıştırmak için Docker Run komutunu kullanın.Use the docker run command to run any of the three containers. Komut aşağıdaki parametreleri kullanır:The command uses the following parameters:

    Önizleme sırasında, kapsayıcıyı başlatmak için faturalandırma ayarlarının geçerli olması gerekir, ancak kullanım için faturalandırılmaz.During the preview, the billing settings must be valid to start the container, but you aren't billed for usage.

    Yer tutucuPlaceholder ValueValue
    {API_KEY}{API_KEY} Bu anahtar, kapsayıcıyı başlatmak için kullanılır ve Azure portal konuşma anahtarları sayfasında kullanılabilir.This key is used to start the container, and is available on the Azure portal's Speech Keys page.
    {ENDPOINT_URI}{ENDPOINT_URI} Faturalandırma uç noktası URI değeri Azure portal konuşmaya Genel Bakış sayfasında kullanılabilir.The billing endpoint URI value is available on the Azure portal's Speech Overview page.

    Aşağıdaki örnek docker run komutta bu parametreleri kendi değerlerinizle değiştirin.Replace these parameters with your own values in the following example docker run command.

    Metin okumaText-to-speech

    docker run --rm -it -p 5000:5000 --memory 2g --cpus 1 \
    containerpreview.azurecr.io/microsoft/cognitive-services-text-to-speech \
    Eula=accept \
    Billing={ENDPOINT_URI} \
    ApiKey={API_KEY}
    

    Konuşmayı Metne DönüştürmeSpeech-to-text

    docker run --rm -it -p 5000:5000 --memory 2g --cpus 2 \
    containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text \
    Eula=accept \
    Billing={ENDPOINT_URI} \
    ApiKey={API_KEY}
    

    Bu komut:This command:

    • Kapsayıcı görüntüsünden bir konuşma kapsayıcısı çalıştırırRuns a Speech container from the container image
    • 2 CPU çekirdeği ve 2 gigabayt (GB) bellek ayırırAllocates 2 CPU cores and 2 gigabytes (GB) of memory
    • 5000 numaralı TCP bağlantı noktasını kullanıma sunar ve sahte TTY için kapsayıcı ayırır.Exposes TCP port 5000 and allocates a pseudo-TTY for the container
    • Kapsayıcıyı çıktıktan sonra otomatik olarak kaldırır.Automatically removes the container after it exits. Kapsayıcı görüntüsü hala ana bilgisayarda kullanılabilir.The container image is still available on the host computer.

    Önemli

    Eula, Billing, Ve ApiKey kapsayıcıyı çalıştırmak için seçenekler belirtilmelidir; Aksi takdirde, kapsayıcı başlatılamıyor.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Daha fazla bilgi için faturalama.For more information, see Billing.

    Kapsayıcının tahmin uç noktasını sorgulamaQuery the container's prediction endpoint

    KapsayıcıContainer Uç NoktaEndpoint
    Konuşmayı Metne DönüştürmeSpeech-to-text ws://localhost:5000/speech/recognition/dictation/cognitiveservices/v1ws://localhost:5000/speech/recognition/dictation/cognitiveservices/v1
    Metin okumaText-to-speech http://localhost:5000/speech/synthesize/cognitiveservices/v1

    Konuşmayı Metne DönüştürmeSpeech-to-text

    Kapsayıcı, konuşma SDK 'sıaracılığıyla erişilen WebSocket tabanlı sorgu uç noktası API 'leri sağlar.The container provides websocket-based query endpoint APIs, that are accessed through the Speech SDK.

    Varsayılan olarak, konuşma SDK 'Sı çevrimiçi konuşma hizmetlerini kullanır.By default, the Speech SDK uses online speech services. Kapsayıcıyı kullanmak için başlatma yöntemini değiştirmeniz gerekir.To use the container, you need to change the initialization method. Aşağıdaki örneklere bakın.See the examples below.

    BekleniyorC#For C#

    Bu Azure-Cloud başlatma çağrısını kullanarak değiştirin:Change from using this Azure-cloud initialization call:

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

    kapsayıcı uç noktasını kullanarak bu çağrıya:to this call using the container endpoint:

    var config = SpeechConfig.FromEndpoint(
        new Uri("ws://localhost:5000/speech/recognition/dictation/cognitiveservices/v1"),
        "YourSubscriptionKey");
    

    Python içinFor Python

    Bu Azure-Cloud başlatma çağrısını kullanarak DeğiştirChange from using this Azure-cloud initialization call

    speech_config = speechsdk.SpeechConfig(
        subscription=speech_key, region=service_region)
    

    kapsayıcı uç noktasını kullanarak bu çağrıya:to this call using the container endpoint:

    speech_config = speechsdk.SpeechConfig(
        subscription=speech_key, endpoint="ws://localhost:5000/speech/recognition/dictation/cognitiveservices/v1")
    

    Metin okumaText-to-speech

    Kapsayıcı, burada bulunan REST uç nokta API 'lerini sağlar ve örnekleri buradabulabilirsiniz.The container provides REST endpoint APIs that can be found here and samples can be found here.

    Bir kapsayıcının çalıştırıldığını doğrulaValidate that a container is running

    Kapsayıcının çalışır durumda olduğunu doğrulamak için birkaç yolu vardır.There are several ways to validate that the container is running.

    İstekRequest AmaçPurpose
    http://localhost:5000/ Kapsayıcı, bir giriş sayfası sağlar.The container provides a home page.
    http://localhost:5000/status Bir uç nokta sorgu neden olmadan kapsayıcının çalışır durumda olduğunu doğrulamak için GET ile istedi.Requested with GET, to validate that the container is running without causing an endpoint query. Bu istek için Kubernetes kullanılabilir canlılık ve hazırlık araştırmaları.This request can be used for Kubernetes liveness and readiness probes.
    http://localhost:5000/swagger Kapsayıcı uç noktaları için tam kümesi sağlar ve bir Try it now özelliği.The container provides a full set of documentation for the endpoints and a Try it now feature. Bu özellik, web tabanlı bir HTML formuna ayarlarınızı girdikten ve herhangi bir kod yazmak zorunda kalmadan sorgunun sağlayın.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. Sorgunun döndürdüğü sonra HTTP üst bilgileri ve gövdesini biçiminde göstermek için gerekli olan bir örnek CURL komutu sağlanır.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

    Kapsayıcının giriş sayfası

    Kapsayıcıyı durdurStop the container

    Burada kapsayıcı çalışıyor, komut satırı ortamında kapsayıcı kapatmaya seçin Ctrl + C.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.

    Sorun gidermeTroubleshooting

    Kapsayıcıyı çalıştırdığınızda kapsayıcı, kapsayıcıyı başlatırken veya çalıştırırken oluşan sorunları gidermeye yardımcı olan bilgileri almak için stdout ve stderr kullanır.When you run the container, the container uses stdout and stderr to output information that is helpful to troubleshoot issues that happen while starting or running the container.

    FaturalandırmaBilling

    Konuşma kapsayıcıları, Azure hesabınızdaki bir konuşma kaynağını kullanarak faturalama bilgilerini Azure 'a gönderir.The Speech containers send billing information to Azure, using a Speech resource on your Azure account.

    Kapsayıcıya sorguları için kullanılan bir Azure kaynak fiyatlandırma katmanını faturalandırılır <ApiKey>.Queries to the container are billed at the pricing tier of the Azure resource that's used for the <ApiKey>.

    Azure Bilişsel hizmetler kapsayıcıları, kullanım ölçümü için fatura uç noktasına bağlı olmadan çalıştırmak için lisanslı değil.Azure Cognitive Services containers aren't licensed to run without being connected to the billing endpoint for metering. Kapsayıcılar, her zaman faturalandırma bilgileri fatura uç noktası ile iletişim kurmak etkinleştirmeniz gerekir.You must enable the containers to communicate billing information with the billing endpoint at all times. Bilişsel hizmetler kapsayıcıları analiz ediliyor, metin ve görüntü gibi müşteri verilerini Microsoft'a gönderme.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

    Azure'a BağlanmaConnect to Azure

    Kapsayıcıyı çalıştırmak için fatura bağımsız değişken değerlerini gerekir.The container needs the billing argument values to run. Bu değerler, fatura uç noktaya bağlanmak kapsayıcı sağlar.These values allow the container to connect to the billing endpoint. Kapsayıcı yaklaşık her 10 ila 15 dakika kullanım raporları.The container reports usage about every 10 to 15 minutes. Kapsayıcı izin verilen zaman penceresi içinde Azure'a bağlanamazsa kapsayıcı çalışmaya devam eder, ancak fatura uç noktayı geri yüklenene kadar sorgular görmese.If the container doesn't connect to Azure within the allowed time window, the container continues to run but doesn't serve queries until the billing endpoint is restored. Bağlantı 10 kez aynı zaman aralığında 10-15 dakika denenir.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Bağlantı kurulamıyor fatura uç nokta 10 içinde çalışır, kapsayıcı çalışmayı durdurur.If it can't connect to the billing endpoint within the 10 tries, the container stops running.

    Faturalandırma bağımsız değişkenleriBilling arguments

    İçin docker run kapsayıcı başlatmak için komut geçerli değerlerle şunlardan üçünü belirtilmesi gerekir:For the docker run command to start the container, all three of the following options must be specified with valid values:

    SeçenekOption AçıklamaDescription
    ApiKey Fatura bilgileri izlemek için kullanılan Bilişsel hizmetler kaynağı API anahtarı.The API key of the Cognitive Services resource that's used to track billing information.
    Bu seçeneğin değeri, belirtilen sağlanan kaynak için bir API anahtarı ayarlanmalıdır Billing.The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
    Billing Bilişsel hizmetler kaynağın faturalandırma bilgileri izlemek için kullanılan uç nokta.The endpoint of the Cognitive Services resource that's used to track billing information.
    Bu seçeneğin değeri, sağlanan bir Azure kaynak URI'sini uç noktasına ayarlamanız gerekir.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
    Eula Kapsayıcı lisansını kabul gösterir.Indicates that you accepted the license for the container.
    Bu seçenek değeri ayarlanmalıdır kabul.The value of this option must be set to accept.

    Bu seçenekler hakkında daha fazla bilgi için bkz. kapsayıcıları yapılandırma.For more information about these options, see Configure containers.

    Blog yazılarıBlog posts

    Geliştirici örnekleriDeveloper samples

    Geliştirici Örnekleri kullanıma sunduğumuz GitHub deposu.Developer samples are available at our GitHub repository.

    Web seminerini izleyinView webinar

    Birleştirme Web Semineri hakkında bilgi edinmek için:Join the webinar to learn about:

    • Bilişsel hizmetler, Docker kullanan herhangi bir makineye dağıtmaHow to deploy Cognitive Services to any machine using Docker
    • Bilişsel hizmetler AKS'ye dağıtmaHow to deploy Cognitive Services to AKS

    ÖzetSummary

    Bu makalede, konuşma kapsayıcılarını indirmek, yüklemek ve çalıştırmak için kavramları ve iş akışını öğrendiniz.In this article, you learned concepts and workflow for downloading, installing, and running Speech containers. Özet:In summary:

    • Konuşma, Docker için konuşmayı metin ve metinden konuşmaya bir şekilde kapsüllemek için iki Linux kapsayıcısı sağlar.Speech provides two Linux containers for Docker, encapsulating speech to text and text to speech.
    • Kapsayıcı görüntüleri Azure 'daki özel kapsayıcı kayıt defterinden indirilir.Container images are downloaded from the private container registry in Azure.
    • Docker kapsayıcı görüntüleri çalıştırın.Container images run in Docker.
    • Kapsayıcının ana bilgisayar URI 'sini belirterek, konuşma kapsayıcılarındaki işlemleri çağırmak için REST API veya SDK kullanabilirsiniz.You can use either the REST API or SDK to call operations in Speech containers by specifying the host URI of the container.
    • Bir kapsayıcıyı örnekledikten sonra faturalandırma bilgilerini sağlamanız gerekir.You're required to provide billing information when instantiating a container.

    Önemli

    Bilişsel hizmetler kapsayıcıları, kullanım ölçümü için Azure'a bağlanmadan çalıştırmak için lisanslanmaz.Cognitive Services containers are not licensed to run without being connected to Azure for metering. Müşteriler, her zaman faturalandırma bilgileri ölçüm hizmeti ile iletişim kurmak kapsayıcıları etkinleştirmeniz gerekiyor.Customers need to enable the containers to communicate billing information with the metering service at all times. Bilişsel hizmetler kapsayıcılar, Microsoft müşteri verilerini (örneğin, görüntü veya metin analiz edilen) göndermeyin.Cognitive Services containers do not send customer data (e.g., the image or text that is being analyzed) to Microsoft.

    Sonraki adımlarNext steps