Installieren und Ausführen von Containern für den Speech-DienstInstall and run Speech Service containers

Mit Speech-Containern können Kunden eine Speech-basierte Anwendungsarchitektur erstellen, die sowohl von widerstandsfähigen Cloudfunktionen als auch von der Edgeposition profitieren kann.Speech containers enable customers to build one speech application architecture that is optimized to take advantage of both robust cloud capabilities and edge locality.

Die beiden Sprachcontainer sind Spracherkennung und Sprachsynthese.The two speech containers are speech-to-text and text-to-speech.

FunktionFunction FeaturesFeatures Neueste VersionLastest
SpracherkennungSpeech-to-text
  • Transkribiert kontinuierliche Echtzeitsprache oder Batchaudioaufzeichnungen in Text mit Zwischenergebnissen.Transcribes continuous real-time speech or batch audio recordings into text with intermediate results.
  • 1.1.11.1.1
    SprachsyntheseText-to-Speech
  • Konvertiert Text in natürlich klingende Sprache.Converts text to natural-sounding speech. mit Nur-Text-Eingabe und SSML (Speech Synthesis Markup Language, Markupsprache für Sprachsynthese).with plain text input or Speech Synthesis Markup Language (SSML).
  • 1.1.01.1.0

    Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.If you don't have an Azure subscription, create a free account before you begin.

    VoraussetzungenPrerequisites

    Für die Verwendung von Speech-Containern müssen folgende Voraussetzungen erfüllt sein:You must meet the following prerequisites before using Speech containers:

    ErforderlichRequired ZweckPurpose
    Docker-EngineDocker Engine Die Docker-Engine muss auf einem Hostcomputer installiert sein.You need the Docker Engine installed on a host computer. Für die Docker-Umgebung stehen Konfigurationspakete für macOS, Windows und Linux zur Verfügung.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. Eine Einführung in Docker und Container finden Sie in der Docker-Übersicht.For a primer on Docker and container basics, see the Docker overview.

    Docker muss so konfiguriert werden, dass die Container eine Verbindung mit Azure herstellen und Abrechnungsdaten an Azure senden können.Docker must be configured to allow the containers to connect with and send billing data to Azure.

    Unter Windows muss Docker auch für die Unterstützung von Linux-Containern konfiguriert werden.On Windows, Docker must also be configured to support Linux containers.

    Kenntnisse zu DockerFamiliarity with Docker Sie sollten über Grundkenntnisse der Konzepte von Docker, einschließlich Registrierungen, Repositorys, Container und Containerimages, verfügen und die grundlegenden docker-Befehle kennen.You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.
    Speech-RessourceSpeech resource Um diese Container verwenden zu können, benötigen Sie Folgendes:In order to use these containers, you must have:

    Eine Azure-Ressource vom Typ Speech, um den entsprechenden Abrechnungsschlüssel und den URI des Abrechnungsendpunkts zu erhalten.A Speech Azure resource to get the associated billing key and billing endpoint URI. Beide Werte stehen im Azure-Portal auf der Übersichts- und auf der Schlüsselseite für Speech zur Verfügung und werden zum Starten des Containers benötigt.Both values are available on the Azure portal's Speech Overview and Keys pages and are required to start the container.

    {BILLING_KEY} : Der Ressourcenschlüssel.{BILLING_KEY}: resource key

    {BILLING_ENDPOINT_URI} : Der Endpunkt-URI. Beispiel: https://westus.api.cognitive.microsoft.com/sts/v1.0{BILLING_ENDPOINT_URI}: endpoint URI example is: https://westus.api.cognitive.microsoft.com/sts/v1.0

    Anfordern des Zugriffs auf die ContainerregistrierungRequest access to the container registry

    Sie müssen zuerst das Formular zum Anfordern von Cognitive Services-Speech-Containern ausfüllen und übermitteln, um Zugriff auf den Container anzufordern.You must first complete and submit the Cognitive Services Speech Containers Request form to request access to the container.

    Im Formular müssen Sie Informationen über Sie selbst, Ihr Unternehmen und das Benutzerszenario eintragen, für das Sie den Container verwenden möchten.The form requests information about you, your company, and the user scenario for which you'll use the container. Nach der Übermittlung des Formulars überprüft das Azure Cognitive Services-Team das Formular, um sicherzustellen, dass Sie die Kriterien für den Zugriff auf die private Containerregistrierung erfüllen.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.

    Wichtig

    Sie müssen im Formular eine E-Mail-Adresse verwenden, die entweder einem Microsoft-Konto (MSA) oder einem Azure Active Directory-Konto (Azure AD) zugeordnet ist.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.

    Wenn Ihre Anforderung genehmigt wurde, erhalten Sie eine E-Mail mit Anweisungen zum Abrufen Ihrer Anmeldeinformationen und zum Zugreifen auf die private Containerregistrierung.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.

    Authentifizieren einer privaten Containerregistrierung mit der Docker-BefehlszeilenschnittstelleUse the Docker CLI to authenticate the private container registry

    Es gibt mehrere Möglichkeiten, sich bei der privaten Containerregistrierung für Cognitive Services-Container zu authentifizieren, aber die empfohlene Methode über die Befehlszeile ist die Verwendung der 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.

    Verwenden Sie den docker login-Befehl wie im folgenden Beispiel gezeigt, um sich bei containerpreview.azurecr.io (der privaten Containerregistrierung für Cognitive Services-Container) anzumelden.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. Ersetzen Sie <username> durch den Benutzernamen und <password> durch das Kennwort. Diese Anmeldeinformationen wurden Ihnen vom Azure Cognitive Services-Team bereitgestellt.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>
    

    Wenn Sie Ihre Anmeldeinformationen in einer Textdatei gesichert haben, können Sie den Inhalt dieser Textdatei über den Befehl cat mit dem Befehl docker login verketten, wie im folgenden Beispiel gezeigt.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. Ersetzen Sie <passwordFile> durch den Pfad und den Namen der Textdatei mit dem Kennwort und <username> durch den Benutzernamen, der in Ihren Anmeldeinformationen angegeben wurde.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
    

    Der HostcomputerThe host computer

    Der Host ist ein x64-basierter Computer, auf dem der Docker-Container ausgeführt wird.The host is a x64-based computer that runs the Docker container. Dies kann ein lokaler Computer oder ein Docker-Hostingdienst in Azure sein, z. B.:It can be a computer on your premises or a Docker hosting service in Azure, such as:

    Unterstützung von Advanced Vector ExtensionsAdvanced Vector Extension support

    Der Host ist der Computer, auf dem der Docker-Container ausgeführt wird.The host is the computer that runs the docker container. Der Host muss Advanced Vector Extensions (AVX2) unterstützen.The host must support Advanced Vector Extensions (AVX2). Auf Linux-Hosts kann diese Unterstützung mithilfe des folgenden Befehls überprüft werden: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
    

    Containeranforderungen und -empfehlungenContainer requirements and recommendations

    In der folgenden Tabelle werden die Mindestanforderungen und empfohlenen Werte für die CPU-Kerne und den Arbeitsspeicher für die einzelnen Speech-Container beschrieben:The following table describes the minimum and recommended CPU cores and memory to allocate for each Speech container.

    ContainerContainer MinimumMinimum EmpfohlenRecommended
    cognitive-services-speech-to-textcognitive-services-speech-to-text Zwei Kerne2 core
    2 GB Arbeitsspeicher2 GB memory
    Vier Kerne4 core
    4 GB Arbeitsspeicher4 GB memory
    cognitive-services-text-to-speechcognitive-services-text-to-speech Ein Kern, 0,5 GB Arbeitsspeicher1 core, 0.5 GB memory Zwei Kerne, 1 GB Arbeitsspeicher2 core, 1 GB memory
    • Jeder Kern muss eine Geschwindigkeit von mindestens 2,6 GHz aufweisen.Each core must be at least 2.6 gigahertz (GHz) or faster.

    Kern und Arbeitsspeicher entsprechen den Einstellungen --cpus und --memory, die im Rahmen des Befehls docker run verwendet werden.Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

    Hinweis: Die Mindestanforderungen und Empfehlungen basieren auf Docker-Grenzwerten, nicht auf den Ressourcen des Hostcomputers.Note; The minimum and recommended are based off of Docker limits, not the host machine resources. Spracherkennungscontainer ordnen beispielsweise Teile des Arbeitsspeichers eines großen Sprachmodells zu, und es wird empfohlen, dass die gesamte Datei in den Arbeitsspeicher passt (was zusätzlich 4 bis 6 GB ausmacht).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. Außerdem dauert die erste Ausführung des Containers unter Umständen länger, da Modelle in den Arbeitsspeicher ausgelagert werden.Also, the first run of the either container may take longer, since models are being paged into memory.

    Abrufen des Containerimages mit docker pullGet the container image with docker pull

    Für Speech stehen folgende Containerimages zur Verfügung:Container images for Speech are available.

    ContainerContainer RepositoryRepository
    cognitive-services-speech-to-textcognitive-services-speech-to-text containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text:latest
    cognitive-services-text-to-speechcognitive-services-text-to-speech containerpreview.azurecr.io/microsoft/cognitive-services-text-to-speech:latest

    Tipp

    Mithilfe des Befehls docker images können Sie Ihre heruntergeladenen Containerimages auflisten.You can use the docker images command to list your downloaded container images. Mit dem folgenden Befehl werden beispielsweise die ID, das Repository und das Tag jedes heruntergeladenen Containerimages in Form einer Tabelle aufgelistet: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
    ebbee78a6baa       <container-name>         latest
    

    Das Sprachgebietsschema ist im Containertag enthalten.Language locale is in container tag

    Das Tag latest pullt das Gebietsschema en-us und die Stimme jessarus.The latest tag pulls the en-us locale and jessarus voice.

    Gebietsschemas für die SpracherkennungSpeech to text locales

    Mit Ausnahme von latest liegen alle Tags im folgenden Format vor, wobei <culture> den Gebietsschemacontainer angibt:All tags, except for latest are in the following format, where the <culture> indicates the locale container:

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

    Das folgende Tag ist ein Beispiel für das Format:The following tag is an example of the format:

    1.0.0-amd64-en-us-preview
    

    Die folgende Tabelle enthält die unterstützten Gebietsschemas für die Spracherkennung in der Version 1.1.1 des Containers:The following table lists the supported locales for speech-to-text in the 1.1.1 version of the container:

    SprachgebietsschemaLanguage locale TagsTags
    ChinesischChinese zh-cn
    EnglischEnglish en-us
    en-gb
    en-au
    en-in
    FranzösischFrench fr-ca
    fr-fr
    DeutschGerman de-de
    ItalienischItalian it-it
    JapanischJapanese ja-jp
    KoreanischKorean ko-kr
    PortugiesischPortuguese pt-br
    SpanischSpanish es-es
    es-mx

    Gebietsschemas für die SprachsyntheseText to speech locales

    Mit Ausnahme von latest liegen alle Tags im folgenden Format vor, wobei <culture> das Gebietsschema und <voice> die Stimme des Containers angibt: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>
    

    Das folgende Tag ist ein Beispiel für das Format:The following tag is an example of the format:

    1.0.0-amd64-en-us-jessarus-preview
    

    Die folgende Tabelle enthält die unterstützten Gebietsschemas für die Sprachsynthese in der Version 1.1.0 des Containers:The following table lists the supported locales for text-to-speech in the 1.1.0 version of the container:

    SprachgebietsschemaLanguage locale TagsTags Unterstützte StimmenSupported voices
    ChinesischChinese zh-cn huihuirushuihuirus
    kangkang-apollokangkang-apollo
    yaoyao-apolloyaoyao-apollo
    EnglischEnglish en-au catherinecatherine
    hayleyrushayleyrus
    EnglischEnglish en-gb george-apollogeorge-apollo
    hazelrushazelrus
    susan-apollosusan-apollo
    EnglischEnglish en-in heera-apolloheera-apollo
    priyaruspriyarus
    ravi-apolloravi-apollo
    EnglischEnglish en-us jessarusjessarus
    benjaminrusbenjaminrus
    jessa24krusjessa24krus
    ziraruszirarus
    guy24krusguy24krus
    FranzösischFrench fr-ca carolinecaroline
    harmonierusharmonierus
    FranzösischFrench fr-fr hortenserushortenserus
    julie-apollojulie-apollo
    paul-apollopaul-apollo
    DeutschGerman de-de heddahedda
    heddarusheddarus
    stefan-apollostefan-apollo
    ItalienischItalian it-it cosimo-apollocosimo-apollo
    luciarusluciarus
    JapanischJapanese ja-jp ayumi-apolloayumi-apollo
    harukarusharukarus
    ichiro-apolloichiro-apollo
    KoreanischKorean ko-kr heamirusheamirus
    PortugiesischPortuguese pt-br daniel-apollodaniel-apollo
    heloisarusheloisarus
    SpanischSpanish es-es elenaruselenarus
    laura-apollolaura-apollo
    pablo-apollopablo-apollo
    SpanischSpanish es-mx hildarushildarus
    raul-apolloraul-apollo

    Docker-Pullvorgang für die Speech-ContainerDocker pull for the speech containers

    SpracherkennungSpeech-to-text

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

    Text-zu-SpracheText-to-speech

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

    Verwenden des ContainersHow to use the container

    Wenn sich der Container auf dem Hostcomputer befindet, können Sie über den folgenden Prozess mit dem Container arbeiten.Once the container is on the host computer, use the following process to work with the container.

    1. Führen Sie den Container aus, und verwenden Sie dabei die erforderlichen, aber nicht verwendeten Abrechnungseinstellungen.Run the container, with the required but not used billing settings. Es sind noch weitere Beispiele für den Befehl docker run verfügbar.More examples of the docker run command are available.
    2. Fragen Sie den Vorhersageendpunkt des Containers ab.Query the container's prediction endpoint.

    Ausführen des Containers mit docker runRun the container with docker run

    Verwenden Sie den Befehl docker run, um einen der drei Container auszuführen.Use the docker run command to run any of the three containers. Für den Befehl werden die folgenden Parameter verwendet:The command uses the following parameters:

    Während der Vorschau müssen die Abrechnungseinstellungen zwar gültig sein, um den Container starten zu können, die Nutzung wird Ihnen jedoch nicht in Rechnung gestellt.During the preview, the billing settings must be valid to start the container, but you aren't billed for usage.

    PlatzhalterPlaceholder WertValue
    {BILLING_KEY}{BILLING_KEY} Dieser Schlüssel wird zum Starten des Containers verwendet und steht im Azure-Portal auf der Schlüsselseite für Speech zur Verfügung.This key is used to start the container, and is available on the Azure portal's Speech Keys page.
    {BILLING_ENDPOINT_URI}{BILLING_ENDPOINT_URI} Den URI des Abrechnungsendpunkts finden Sie im Azure-Portal auf der Speech-Übersichtsseite.The billing endpoint URI value is available on the Azure portal's Speech Overview page.

    Ersetzen Sie im folgenden Beispiel für den Befehl docker run diese Parameter durch Ihre eigenen Werte.Replace these parameters with your own values in the following example docker run command.

    Text-zu-SpracheText-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={BILLING_ENDPOINT_URI} \
    ApiKey={BILLING_KEY} 
    

    SpracherkennungSpeech-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={BILLING_ENDPOINT_URI} \
    ApiKey={BILLING_KEY} 
    

    Dieser Befehl:This command:

    • Führt einen Speech-Container auf der Grundlage des Containerimages ausRuns a Speech container from the container image
    • Ordnet zwei CPU-Kerne und 2 GB Arbeitsspeicher zuAllocates 2 CPU cores and 2 gigabytes (GB) of memory
    • Verfügbarmachen des TCP-Ports 5000 und Zuweisen einer Pseudo-TTY-Verbindung für den ContainerExposes TCP port 5000 and allocates a pseudo-TTY for the container
    • Entfernt den Container automatisch, nachdem er beendet wurde.Automatically removes the container after it exits. Das Containerimage ist auf dem Hostcomputer weiterhin verfügbar.The container image is still available on the host computer.

    Wichtig

    Die Optionen Eula, Billing und ApiKey müssen angegeben werden, um den Container auszuführen, andernfalls wird der Container nicht gestartet.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Weitere Informationen finden Sie unter Abrechnung.For more information, see Billing.

    Abfragen des Vorhersageendpunkts des ContainersQuery the container's prediction endpoint

    ContainerContainer EndpunktEndpoint
    SpracherkennungSpeech-to-text ws://localhost:5000/speech/recognition/dictation/cognitiveservices/v1ws://localhost:5000/speech/recognition/dictation/cognitiveservices/v1
    Text-zu-SpracheText-to-speech http://localhost:5000/speech/synthesize/cognitiveservices/v1

    SpracherkennungSpeech-to-text

    Der Container bietet websocketbasierte Abfrageendpunkt-APIs, auf die über das Speech SDK zugegriffen wird.The container provides websocket-based query endpoint APIs, that are accessed through the Speech SDK.

    Standardmäßig verwendet das Speech SDK Online-Speech-Dienste.By default, the Speech SDK uses online speech services. Um den Container verwenden zu können, müssen Sie die Initialisierungsmethode ändern.To use the container, you need to change the initialization method. Weitere Informationen finden Sie in den folgenden Beispielen.See the examples below.

    C#For C#

    Ändern Sie den folgenden Azure-CloudinitialisierungsaufrufChange from using this Azure-cloud initialization call:

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

    in den folgenden Aufruf mit dem Containerendpunkt:to this call using the container endpoint:

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

    PythonFor Python

    Ändern Sie den folgenden Azure-CloudinitialisierungsaufrufChange from using this Azure-cloud initialization call

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

    in den folgenden Aufruf mit dem Containerendpunkt:to this call using the container endpoint:

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

    Text-zu-SpracheText-to-speech

    Die vom Container bereitgestellten REST-Endpunkt-APIs finden Sie hier. Beispiele finden Sie hier.The container provides REST endpoint APIs which can be found here and samples can be found here.

    Überprüfen auf aktive ContainerValidate that a container is running

    Es gibt mehrere Möglichkeiten zu überprüfen, ob ein Container aktiv ist.There are several ways to validate that the container is running.

    AnforderungRequest ZweckPurpose
    http://localhost:5000/ Der Container stellt eine Homepage bereit.The container provides a home page.
    http://localhost:5000/status Anforderung mit GET, um zu überprüfen, ob der Container aktiv ist, ohne eine Endpunktabfrage zu verursachen.Requested with GET, to validate that the container is running without causing an endpoint query. Diese Anforderung kann für Live- und Bereitschaftstests von Kubernetes verwendet werden.This request can be used for Kubernetes liveness and readiness probes.
    http://localhost:5000/swagger Der Container stellt eine umfassende Dokumentation für die Endpunkte sowie die Funktion Try it now bereit.The container provides a full set of documentation for the endpoints and a Try it now feature. Diese Funktion ermöglicht Ihnen die Eingabe Ihrer Einstellungen in einem webbasierten HTML-Formular, sodass Sie die Abfrage ausführen können, ohne Code schreiben zu müssen.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. Nach der Rückgabe der Abfrage wird ein cURL-Beispielbefehl bereitgestellt, der das erforderliche Format für HTTP-Header und -Text veranschaulicht.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

    Homepage des Containers

    Beenden des ContainersStop the container

    Zum Herunterfahren des Containers drücken Sie in der Befehlszeilenumgebung, in der der Container ausgeführt wird, STRG+C.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.

    ProblembehandlungTroubleshooting

    Wenn Sie den Container ausführen, werden mithilfe von stdout und stderr Informationen ausgegeben, die hilfreich sind, um Probleme beim Starten oder Ausführen des Containers zu beheben.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.

    AbrechnungBilling

    Der Speech-Container sendet Abrechnungsinformationen an Azure und verwendet dafür eine Ressource vom Typ Speech in Ihrem Azure-Konto.The Speech containers send billing information to Azure, using a Speech resource on your Azure account.

    Abfragen des Containers werden mit dem Tarif der Azure-Ressource in Ressource gestellt, die für den <ApiKey> verwendet wird.Queries to the container are billed at the pricing tier of the Azure resource used for the <ApiKey>.

    Für die Ausführung von Azure Cognitive Services-Containern besteht keine Lizenz, wenn sie nicht zu Messzwecken mit dem Abrechnungsendpunkt verbunden sind.Azure Cognitive Services containers aren't licensed to run without being connected to the billing endpoint for metering. Sie müssen sicherstellen, dass die Container jederzeit Abrechnungsinformationen an den Abrechnungsendpunkt übermitteln können.You must enable the containers to communicate billing information with the billing endpoint at all times. Cognitive Services-Container senden keine Kundendaten (z. B. das analysierte Bild oder den analysierten Text) an Microsoft.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

    Herstellen einer Verbindung mit AzureConnect to Azure

    Der Container benötigt die Abrechnungsargumentwerte, um ausgeführt werden zu können.The container needs the billing argument values to run. Diese Werte ermöglichen es dem Container, eine Verbindung mit dem Abrechnungsendpunkt herzustellen.These values allow the container to connect to the billing endpoint. Der Container meldet die Nutzung etwa alle 10 bis 15 Minuten.The container reports usage about every 10 to 15 minutes. Wenn der Container nicht innerhalb des zulässigen Zeitfensters eine Verbindung mit Azure herstellt, wird der Container weiterhin ausgeführt, verarbeitet aber keine Anfragen, bis der Abrechnungsendpunkt wiederhergestellt wurde.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. Es erfolgen 10 Verbindungsversuche im gleichen Zeitintervall von 10 bis 15 Minuten.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Wenn die Verbindung mit dem Abrechnungsendpunkt nicht innerhalb der 10 Versuche hergestellt werden kann, wird die Ausführung des Containers beendet.If it can't connect to the billing endpoint within the 10 tries, the container stops running.

    AbrechnungsargumenteBilling arguments

    Alle drei der folgenden Optionen müssen mit gültigen Werten angegeben werden, damit der Container mit dem Befehl docker run gestartet wird.All three of the following options must be specified with valid values in order for the docker run command to start the container.

    OptionOption BESCHREIBUNGDescription
    ApiKey Der API-Schlüssel der Cognitive Services-Ressource, der zum Nachverfolgen von Abrechnungsinformationen verwendet wird.The API key of the Cognitive Services resource used to track billing information.
    Der Wert dieser Option muss für die bereitgestellte Ressource, die in Billing angegeben wurde, auf einen API-Schlüssel festgelegt werden.The value of this option must be set to an API key for the provisioned resource specified in Billing.
    Billing Der Endpunkt der Cognitive Services-Ressource, der zum Nachzuverfolgen von Abrechnungsinformationen verwendet wird.The endpoint of the Cognitive Services resource used to track billing information.
    Der Wert dieser Option muss auf den Endpunkt-URI einer bereitgestellten Azure-Ressource festgelegt werden.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
    Eula Gibt an, dass Sie die Lizenz für den Container akzeptiert haben.Indicates that you accepted the license for the container.
    Der Wert dieser Option muss auf accept festgelegt werden.The value of this option must be set to accept.

    Weitere Informationen zu diesen Optionen finden Sie unter Konfigurieren von Containern.For more information about these options, see Configure containers.

    BlogbeiträgeBlog posts

    EntwicklerbeispieleDeveloper samples

    Beispiele für Entwickler finden Sie in unserem GitHub-Repository.Developer samples are available at our GitHub repository.

    Anzeigen des WebinarsView webinar

    Im Webinar erhalten Sie Informationen zu folgenden Aktionen:Join the webinar to learn about:

    • Bereitstellen von Cognitive Services auf einem beliebigen Computer mit DockerHow to deploy Cognitive Services to any machine using Docker
    • Bereitstellen von Cognitive Services in AKSHow to deploy Cognitive Services to AKS

    ZusammenfassungSummary

    In diesem Artikel haben Sie die Konzepte und den Workflow zum Herunterladen, Installieren und Ausführen von Speech-Containern kennengelernt.In this article, you learned concepts and workflow for downloading, installing, and running Speech containers. Zusammenfassung:In summary:

    • Speech stellt zur Kapselung von Spracherkennung und Sprachsynthese zwei Linux-Container für Docker bereit.Speech provides two Linux containers for Docker, encapsulating speech to text and text to speech.
    • Containerimages werden aus der privaten Containerregistrierung in Azure heruntergeladen.Container images are downloaded from the private container registry in Azure.
    • Containerimages werden in Docker ausgeführt.Container images run in Docker.
    • Sie können entweder die REST-API oder das SDK verwenden, um Vorgänge in Speech-Containern über den Host-URI des Containers aufzurufen.You can use either the REST API or SDK to call operations in Speech containers by specifying the host URI of the container.
    • Bei der Instanziierung eines Containers müssen Sie Abrechnungsinformationen angeben.You must specify billing information when instantiating a container.

    Wichtig

    Für die Ausführung von Cognitive Services-Containern besteht keine Lizenz, wenn sie nicht zu Messzwecken mit Azure verbunden sind.Cognitive Services containers are not licensed to run without being connected to Azure for metering. Kunden müssen sicherstellen, dass Container jederzeit Abrechnungsinformationen an den Messungsdienst übermitteln können.Customers need to enable the containers to communicate billing information with the metering service at all times. Cognitive Services-Container senden keine Kundendaten (z.B. das analysierte Bild oder den analysierten Text) an Microsoft.Cognitive Services containers do not send customer data (e.g., the image or text that is being analyzed) to Microsoft.

    Nächste SchritteNext steps