Speech Service-containers installeren en uitvoeren (preview-versie)Install and run Speech service containers (Preview)

Met containers kunt u enkele Api's van de speech-service uitvoeren in uw eigen omgeving.Containers enable you to run some of the Speech service APIs in your own environment. Containers zijn geweldig voor specifieke vereisten voor beveiliging en gegevens beheer.Containers are great for specific security and data governance requirements. In dit artikel leert u hoe u een spraak container downloadt, installeert en uitvoert.In this article you'll learn how to download, install, and run a Speech container.

Met spraak containers kunnen klanten een spraak toepassings architectuur maken die is geoptimaliseerd voor zowel robuuste Cloud mogelijkheden als Edge-locatie.Speech containers enable customers to build a speech application architecture that is optimized for both robust cloud capabilities and edge locality. Er zijn vier verschillende containers beschikbaar.There are four different containers available. De twee standaard containers zijn spraak-naar-tekst en tekst-naar-spraak.The two standard containers are Speech-to-text and Text-to-speech. De twee aangepaste containers zijn Custom speech-naar-tekst -en aangepaste tekst-naar-spraak.The two custom containers are Custom Speech-to-text and Custom Text-to-speech. Spraak containers hebben dezelfde prijzen als de op de cloud gebaseerde Azure speech Services.Speech containers have the same pricing as the cloud-based Azure Speech Services.

Belangrijk

Alle spraak containers worden momenteel aangeboden als onderdeel van een open bare preview-versie.All speech containers are currently offered as part of a Public "Gated" Preview. Er wordt een aankondiging gedaan wanneer de voortgang van de spraak containers op algemene Beschik baarheid (GA) wordt weer gegeven.An announcement will be made when speech containers progress to General Availability (GA).

FunctieFunction FunctiesFeatures JongsteLatest
Spraak naar tekstSpeech-to-text Analyseert sentiment en transcribeert doorlopend realtime spraak of batch audio-opnamen met tussenliggende resultaten.Analyzes sentiment and transcribes continuous real-time speech or batch audio recordings with intermediate results. 2.3.12.3.1
Custom Speech-naar-tekstCustom Speech-to-text Door gebruik te maken van een aangepast model van de Custom speech Portal, transcribeert doorlopend realtime spraak of batch opnames in tekst met tussenliggende resultaten.Using a custom model from the Custom Speech portal, transcribes continuous real-time speech or batch audio recordings into text with intermediate results. 2.3.12.3.1
Tekst naar spraakText-to-speech Hiermee wordt tekst geconverteerd naar een spreek spraak met tekst zonder opmaak of een SSML (Speech synthese Markup Language).Converts text to natural-sounding speech with plain text input or Speech Synthesis Markup Language (SSML). 1.5.01.5.0
Aangepaste tekst-naar-spraakCustom Text-to-speech Door gebruik te maken van een aangepast model van de aangepaste Voice Portal, converteert u tekst naar een natuurlijk geluids fragment met de invoer van een tekst zonder opmaak of een SSML (Speech synthese Markup Language).Using a custom model from the Custom Voice portal, converts text to natural-sounding speech with plain text input or Speech Synthesis Markup Language (SSML). 1.5.01.5.0

Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.If you don't have an Azure subscription, create a free account before you begin.

VereistenPrerequisites

De volgende vereisten voordat u spraak containers gebruikt:The following prerequisites before using Speech containers:

VereistRequired DoelPurpose
Docker-engineDocker Engine De docker-engine moet zijn geïnstalleerd op een hostcomputer.You need the Docker Engine installed on a host computer. Docker biedt pakketten waarmee de Docker-omgeving op MacOS, Windows en Linux kan worden geconfigureerd.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. Zie het Docker-overzicht voor een inleiding tot de basisprincipes van Docker en containers.For a primer on Docker and container basics, see the Docker overview.

Docker moet worden geconfigureerd zodat de containers verbinding kunnen maken met en facturerings gegevens kunnen verzenden naar Azure.Docker must be configured to allow the containers to connect with and send billing data to Azure.

In Windowsmoet docker ook worden geconfigureerd voor de ondersteuning van Linux-containers.On Windows, Docker must also be configured to support Linux containers.

Vertrouwd met dockerFamiliarity with Docker U moet een basis kennis hebben van docker-concepten, zoals registers, opslag plaatsen, containers en container installatie kopieën, en kennis van basis docker opdrachten.You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.
Spraak resourceSpeech resource Als u deze containers wilt gebruiken, hebt u het volgende nodig:In order to use these containers, you must have:

Een Azure- spraak bron om de bijbehorende API-sleutel en eind punt-URI op te halen.An Azure Speech resource to get the associated API key and endpoint URI. Beide waarden zijn beschikbaar op het spraak overzicht van de Azure Portal en op de pagina sleutels.Both values are available on the Azure portal's Speech Overview and Keys pages. Ze zijn beide nodig om de container te starten.They are both required to start the container.

{API_KEY}: een van de twee beschik bare bron sleutels op de pagina sleutels{API_KEY}: One of the two available resource keys on the Keys page

{ENDPOINT_URI}: het eind punt op de pagina overzicht{ENDPOINT_URI}: The endpoint as provided on the Overview page

Toegang aanvragen tot het container registerRequest access to the container registry

Vul het aanvraag formulier in en verzend het om toegang tot de container aan te vragen.Fill out and submit the request form to request access to the container.

Het formulier vraagt informatie over u, uw bedrijf en het gebruikers scenario waarvoor u de container gaat gebruiken.The form requests information about you, your company, and the user scenario for which you'll use the container. Nadat u het formulier hebt verzonden, wordt het door het Azure Cognitive Services-team beoordeeld om te controleren of u voldoet aan de criteria voor toegang tot het persoonlijke container register.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.

Belangrijk

U moet een e-mail adres gebruiken dat is gekoppeld aan een account van een micro soft-account (MSA) of Azure Active Directory (Azure AD) in het formulier.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.

Als uw aanvraag is goedgekeurd, ontvangt u een e-mail bericht met instructies voor het verkrijgen van uw referenties en het openen van het persoonlijke container register.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.

De docker-CLI gebruiken om het persoonlijke container register te verifiërenUse the Docker CLI to authenticate the private container registry

U kunt zich op verschillende manieren verifiëren met het persoonlijke container register voor Cognitive Services containers, maar de aanbevolen methode van de opdracht regel is het gebruik van de 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.

Gebruik de docker login opdracht, zoals in het volgende voor beeld wordt weer gegeven, om u aan te melden bij containerpreview.azurecr.io , het persoonlijke container register voor Cognitive Services containers.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. Vervang * < username > * door de gebruikers naam en het * < wacht woord > * met het wacht woord dat is opgegeven in de referenties die u hebt ontvangen van het Azure Cognitive Services-team.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>

Als u uw referenties in een tekst bestand hebt beveiligd, kunt u de inhoud van het tekst bestand samen voegen met behulp van de cat opdracht, docker login zoals in het volgende voor beeld wordt weer gegeven.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. Vervang * < passwordFile > * door het pad en de naam van het tekst bestand dat het wacht woord en de * < gebruikers > * naam bevat met de gebruikers naam die is opgegeven in uw referenties.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

Vereiste para meters verzamelenGathering required parameters

Er zijn drie primaire para meters voor alle vereiste containers van Cognitive Services.There are three primary parameters for all Cognitive Services' containers that are required. De gebruiksrecht overeenkomst (EULA) moet aanwezig zijn met een waarde van accept.The end-user license agreement (EULA) must be present with a value of accept. Daarnaast zijn zowel een eind punt-URL als een API-sleutel nodig.Additionally, both an Endpoint URL and API Key are needed.

Eind punt-URI{ENDPOINT_URI}Endpoint URI {ENDPOINT_URI}

De URI-waarde van het eind punt is beschikbaar op de pagina overzicht van Azure portal van de bijbehorende cognitieve service resource.The Endpoint URI value is available on the Azure portal Overview page of the corresponding Cognitive Service resource. Ga naar de overzichts pagina, beweeg de muis aanwijzer over het Copy to clipboard eind punt en er wordt een pictogram weer gegeven.Navigate to the Overview page, hover over the Endpoint, and a Copy to clipboard icon will appear. Kopieer en gebruik waar nodig.Copy and use where needed.

De URI van het eind punt verzamelen voor later gebruik

Subknooppuntsleutels{API_KEY}Keys {API_KEY}

Deze sleutel wordt gebruikt om de container te starten en is beschikbaar op de pagina sleutels van de Azure Portal van de bijbehorende cognitieve service resource.This key is used to start the container, and is available on the Azure portal's Keys page of the corresponding Cognitive Service resource. Ga naar de pagina sleutels en klik op het Copy to clipboard pictogram.Navigate to the Keys page, and click on the Copy to clipboard icon.

Een van de twee sleutels ophalen voor later gebruik

Belangrijk

Deze abonnements sleutels worden gebruikt om toegang te krijgen tot uw API voor de cognitieve service.These subscription keys are used to access your Cognitive Service API. Deel uw sleutels niet.Do not share your keys. Sla ze veilig op, bijvoorbeeld met behulp van Azure Key Vault.Store them securely, for example, using Azure Key Vault. We raden u ook aan deze sleutels regel matig opnieuw te genereren.We also recommend regenerating these keys regularly. Er is slechts één sleutel nodig om een API-aanroep te maken.Only one key is necessary to make an API call. Wanneer u de eerste sleutel opnieuw genereert, kunt u de tweede sleutel gebruiken voor verdere toegang tot de service.When regenerating the first key, you can use the second key for continued access to the service.

De hostcomputerThe host computer

De host is een op x64 gebaseerde computer waarop de docker-container wordt uitgevoerd.The host is a x64-based computer that runs the Docker container. Dit kan een computer in uw locatie zijn of een docker-hosting service in azure, zoals:It can be a computer on your premises or a Docker hosting service in Azure, such as:

Ondersteuning voor geavanceerde vector uitbreidingenAdvanced Vector Extension support

De host is de computer waarop de docker-container wordt uitgevoerd.The host is the computer that runs the docker container. De host moet ondersteuning bieden voor Geavanceerde vector uitbreidingen (AVX2).The host must support Advanced Vector Extensions (AVX2). U kunt de AVX2-ondersteuning op Linux-hosts controleren met de volgende opdracht:You can check for AVX2 support on Linux hosts with the following command:

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

Waarschuwing

De hostcomputer is vereist voor de ondersteuning van AVX2.The host computer is required to support AVX2. De container werkt niet correct zonder ondersteuning voor AVX2.The container will not function correctly without AVX2 support.

Container vereisten en aanbevelingenContainer requirements and recommendations

In de volgende tabel wordt de minimale en aanbevolen toewijzing van resources voor elke spraak container beschreven.The following table describes the minimum and recommended allocation of resources for each Speech container.

ContainerContainer MinimumMinimum AanbevolenRecommended
Spraak naar tekstSpeech-to-text 2 Core, 2 GB geheugen2 core, 2-GB memory 4-core, 4 GB geheugen4 core, 4-GB memory
  • Elke kern moet ten minste 2,6 gigahertz (GHz) of sneller zijn.Each core must be at least 2.6 gigahertz (GHz) or faster.

Core en geheugen komen overeen met --cpus de --memory instellingen en, die worden gebruikt als onderdeel van de docker run opdracht.Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

Notitie

De minimale en aanbevolen waarde zijn gebaseerd op de limieten van docker, niet op de hostcomputer.The minimum and recommended are based off of Docker limits, not the host machine resources. Bijvoorbeeld: spraak naar tekst containers delen van een groot taal model en het wordt Aanbevolen dat het hele bestand in het geheugen past, wat een extra 4-6 GB is.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. Het is ook mogelijk dat de eerste uitvoering van een van de containers langer duurt, omdat modellen in het geheugen worden gewisseld.Also, the first run of either container may take longer, since models are being paged into memory.

De container installatie kopie ophalen metdocker pullGet the container image with docker pull

Container installatie kopieën voor spraak zijn beschikbaar in de volgende Container Registry.Container images for Speech are available in the following Container Registry.

ContainerContainer OpslagplaatsRepository
Spraak naar tekstSpeech-to-text containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text:latest

Tip

U kunt de opdracht docker-installatie kopieën gebruiken om de gedownloade container installatie kopieën weer te geven.You can use the docker images command to list your downloaded container images. Met de volgende opdracht worden bijvoorbeeld de ID, opslag plaats en label van elke gedownloade container installatie kopie weer gegeven, opgemaakt als een tabel: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>

Docker-pull voor de spraak containersDocker pull for the Speech containers

Docker-pull voor de spraak-naar-tekst-containerDocker pull for the Speech-to-text container

Gebruik de opdracht docker pull om een container installatie kopie te downloaden uit het REGI ster van container voorbeelden.Use the docker pull command to download a container image from Container Preview registry.

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

Belangrijk

De latest tag haalt de en-US land instelling op.The latest tag pulls the en-US locale. Zie voor aanvullende land instellingen voor spraak naar tekst.For additional locales see Speech-to-text locales.

Spraak-naar-tekst-land instellingenSpeech-to-text locales

Alle tags, met uitzonde ring van voor, latest hebben de volgende indeling en zijn hoofdletter gevoelig:All tags, except for latest are in the following format and are case-sensitive:

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

De volgende code is een voor beeld van de indeling:The following tag is an example of the format:

2.3.1-amd64-en-us-preview

Zie voor alle ondersteunde land instellingen van de spraak-naar-tekst -container Tags voor spraak-naar-tekst-afbeelding.For all of the supported locales of the speech-to-text container, please see Speech-to-text image tags.

De container gebruikenHow to use the container

Wanneer de container zich op de hostcomputerbevindt, gebruikt u het volgende proces om met de container te werken.Once the container is on the host computer, use the following process to work with the container.

  1. Voer de container uitmet de vereiste facturerings instellingen.Run the container, with the required billing settings. Er zijn meer voor beelden van de docker run opdracht beschikbaar.More examples of the docker run command are available.
  2. Zoek het Voorspellings eindpunt van de containerop.Query the container's prediction endpoint.

Voer de container uit metdocker runRun the container with docker run

Gebruik de opdracht docker run om de container uit te voeren.Use the docker run command to run the container. Raadpleeg de vereiste para meters verzamelen voor meer informatie over het ophalen van de {Endpoint_URI} {API_Key} waarden en.Refer to gathering required parameters for details on how to get the {Endpoint_URI} and {API_Key} values. Er zijn ook aanvullende voor beelden van de docker run opdracht beschikbaar.Additional examples of the docker run command are also available.

Voer de volgende opdracht uit om de spraak-naar-tekst -container uit te voeren docker run .To run the Speech-to-text container, execute the following docker run command.

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

Met deze opdracht gebeurt het volgende:This command:

  • Voert een spraak-naar-tekst -container uit vanuit de container installatie kopie.Runs a Speech-to-text container from the container image.
  • Wijst 4 CPU-kernen en 4 GB aan geheugen toe.Allocates 4 CPU cores and 4 gigabytes (GB) of memory.
  • Beschrijft TCP-poort 5000 en wijst een pseudo-TTY voor de container toe.Exposes TCP port 5000 and allocates a pseudo-TTY for the container.
  • Verwijdert de container automatisch nadat deze is afgesloten.Automatically removes the container after it exits. De container installatie kopie is nog steeds beschikbaar op de hostcomputer.The container image is still available on the host computer.

Sentiment analyseren voor de uitvoer van spraak naar tekstAnalyze sentiment on the speech-to-text output

Vanaf v 2.2.0 van de spraak-naar-tekst-container, kunt u de API voor sentiment Analysis v3 op de uitvoer aanroepen.Starting in v2.2.0 of the speech-to-text container, you can call the sentiment analysis v3 API on the output. Voor het aanroepen van sentiment-analyse hebt u een Text Analytics-API resource-eind punt nodig.To call sentiment analysis, you will need a Text Analytics API resource endpoint. Bijvoorbeeld:For example:

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

Als u toegang hebt tot een tekst analyse-eind punt in de Cloud, hebt u een sleutel nodig.If you're accessing a Text analytics endpoint in the cloud, you will need a key. Als u Text Analytics lokaal uitvoert, hoeft u dit mogelijk niet op te geven.If you're running Text Analytics locally, you may not need to provide this.

De sleutel en het eind punt worden door gegeven aan de spraak container als argumenten, zoals in het volgende voor beeld.The key and endpoint are passed to the Speech container as arguments, as in the following example.

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

Met deze opdracht gebeurt het volgende:This command:

  • Voert dezelfde stappen uit als hierboven.Performs the same steps as the command above.
  • Slaat een Text Analytics-API-eind punt en-sleutel op voor het verzenden van sentiment-analyse aanvragen.Stores a Text Analytics API endpoint and key, for sending sentiment analysis requests.

Belangrijk

De Eula Billing Opties, en ApiKey moeten worden opgegeven om de container uit te voeren. anders wordt de container niet gestart.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Zie factureringvoor meer informatie.For more information, see Billing.

Een query uitvoeren op het voorspellingseindpunt van de containerQuery the container's prediction endpoint

Notitie

Gebruik een uniek poort nummer als u meerdere containers uitvoert.Use a unique port number if you're running multiple containers.

ContainersContainers SDK-host-URLSDK Host URL ProtocolProtocol
Spraak naar tekst en Custom Speech-naar-tekstSpeech-to-text and Custom Speech-to-text ws://localhost:5000 WSWS
Tekst-naar-spraak en aangepaste tekst-naar-spraakText-to-speech and Custom Text-to-speech http://localhost:5000 HTTPHTTP

Zie Container Security(Engelstalig) voor meer informatie over het gebruik van WSS-en HTTPS-protocollen.For more information on using WSS and HTTPS protocols, see container security.

Spraak-naar-tekst-of Custom Speech-naar-tekstSpeech-to-text or Custom Speech-to-text

De container biedt Api's voor query-eind punten op basis van websockets die worden geopend via de Speech SDK.The container provides websocket-based query endpoint APIs, that are accessed through the Speech SDK. De Speech SDK maakt standaard gebruik van online spraak Services.By default, the Speech SDK uses online speech services. Als u de container wilt gebruiken, moet u de initialisatie methode wijzigen.To use the container, you need to change the initialization method.

Tip

Wanneer u de Speech SDK met containers gebruikt, hoeft u de Azure speech resource Subscription-sleutel of een verificatie Bearer-tokenniet op te geven.When using the Speech SDK with containers, you do not need to provide the Azure Speech resource subscription key or an authentication bearer token.

Zie de onderstaande voorbeelden.See the examples below.

Wijzigen van het gebruik van deze Azure-Cloud initialisatie aanroep:Change from using this Azure-cloud initialization call:

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

voor deze aanroep via de container- host:to this call using the container host:

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

Stemming analyserenAnalyze sentiment

Als u uw Text Analytics-API referenties aan de containerhebt gegeven, kunt u de Speech SDK gebruiken voor het verzenden van aanvragen voor spraak herkenning met sentiment analyse.If you provided your Text Analytics API credentials to the container, you can use the Speech SDK to send speech recognition requests with sentiment analysis. U kunt de API-antwoorden zo configureren dat ze een eenvoudige of gedetailleerde indeling hebben.You can configure the API responses to use either a simple or detailed format.

Als u de speech-client wilt configureren voor gebruik van een eenvoudige indeling, voegt u "Sentiment" als waarde voor toe Simple.Extensions .To configure the Speech client to use a simple format, add "Sentiment" as a value for Simple.Extensions. Als u een specifieke versie van Text Analytics model wilt kiezen, vervangt u 'latest' in de configuratie van de speechcontext-phraseDetection.sentimentAnalysis.modelversion eigenschap.If you want to choose a specific Text Analytics model version, replace 'latest' in the speechcontext-phraseDetection.sentimentAnalysis.modelversion property configuration.

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.Extensionsretourneert het sentiment-resultaat in de hoofdlaag van het antwoord.Simple.Extensions will return the sentiment result in root layer of the response.

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

Als u de sentiment-analyse volledig wilt uitschakelen, voegt u een false waarde toe aan sentimentanalysis.enabled .If you want to completely disable sentiment analysis, add a false value to sentimentanalysis.enabled.

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

Tekst-naar-spraak of aangepaste tekst-naar-spraakText-to-speech or Custom Text-to-speech

De container bevat op rest gebaseerde eind punt-api's.The container provides REST-based endpoint APIs. Er zijn veel voorbeeld broncode projecten voor platform-, Framework-en taal variaties beschikbaar.There are many sample source code projects for platform, framework, and language variations available.

Met de standaard-tekst-naar-spraak -container moet u vertrouwen op de land instelling en de stem van de afbeeldings code die u hebt gedownload.With the Standard Text-to-speech container, you should rely on the locale and voice of the image tag you downloaded. Als u bijvoorbeeld de latest tag hebt gedownload, is en-US de standaard land instelling en JessaRUS de stem.For example, if you downloaded the latest tag the default locale is en-US and the JessaRUS voice. Het {VOICE_NAME} argument zou dan zijn en-US-JessaRUS.The {VOICE_NAME} argument would then be en-US-JessaRUS. Zie het onderstaande voor beeld SSML:See the example SSML below:

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

Voor aangepaste tekst-naar-spraak moet u echter de spraak of het model ophalen van de aangepaste Voice Portal.However, for Custom Text-to-speech you'll need to obtain the Voice / model from the custom voice portal. De naam van het aangepaste model is synoniem met de naam van de stem.The custom model name is synonymous with the voice name. Ga naar de pagina training en kopieer de spraak/model die u als {VOICE_NAME} argument wilt gebruiken.Navigate to the Training page, and copy the Voice / model to use as the {VOICE_NAME} argument.

Aangepast spraak model-spraak naam

Zie het onderstaande voor beeld SSML:See the example SSML below:

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

Laten we een HTTP POST-aanvraag maken, waardoor er een paar koppen en een gegevens lading worden opgegeven.Let's construct an HTTP POST request, providing a few headers and a data payload. Vervang de {VOICE_NAME} tijdelijke aanduiding door uw eigen waarde.Replace the {VOICE_NAME} placeholder with your own value.

curl -s -v -X POST http://localhost:5000/speech/synthesize/cognitiveservices/v1 \
 -H 'Accept: audio/*' \
 -H 'Content-Type: application/ssml+xml' \
 -H 'X-Microsoft-OutputFormat: riff-16khz-16bit-mono-pcm' \
 -d '<speak version="1.0" xml:lang="en-US"><voice name="{VOICE_NAME}">This is a test, only a test.</voice></speak>'

Met deze opdracht gebeurt het volgende:This command:

  • Construct een HTTP POST-aanvraag voor het speech/synthesize/cognitiveservices/v1 eind punt.Constructs an HTTP POST request for the speech/synthesize/cognitiveservices/v1 endpoint.
  • Hiermee geeft Accept u een kop vanaudio/*Specifies an Accept header of audio/*
  • Hiermee geeft Content-Type u een application/ssml+xmlkop van op. Zie aanvraag tekstvoor meer informatie.Specifies a Content-Type header of application/ssml+xml, for more information, see request body.
  • Hiermee geeft X-Microsoft-OutputFormat u een riff-16khz-16bit-mono-pcmkop van op. Zie audio-uitvoervoor meer opties.Specifies a X-Microsoft-OutputFormat header of riff-16khz-16bit-mono-pcm, for more options see audio output.
  • Verzendt de SSML-aanvraag (Speech synthese Markup Language) {VOICE_NAME} die is gegeven aan het eind punt.Sends the Speech Synthesis Markup Language (SSML) request given the {VOICE_NAME} to the endpoint.

Meerdere containers op dezelfde host uitvoerenRun multiple containers on the same host

Als u van plan bent om meerdere containers met blootgestelde poorten uit te voeren, moet u ervoor zorgen dat elke container wordt uitgevoerd met een andere beschik bare poort.If you intend to run multiple containers with exposed ports, make sure to run each container with a different exposed port. Voer bijvoorbeeld de eerste container uit op poort 5000 en de tweede container op poort 5001.For example, run the first container on port 5000 and the second container on port 5001.

U kunt deze container en een andere Azure Cognitive Services-container die samen op de HOST wordt uitgevoerd.You can have this container and a different Azure Cognitive Services container running on the HOST together. U kunt ook meerdere containers van hetzelfde Cognitive Services-container uitvoeren.You also can have multiple containers of the same Cognitive Services container running.

Controleren of een container wordt uitgevoerdValidate that a container is running

Er zijn verschillende manieren om te controleren of de container wordt uitgevoerd.There are several ways to validate that the container is running. Zoek het externe IP- adres en de weer gegeven poort van de betreffende container en open uw favoriete webbrowser.Locate the External IP address and exposed port of the container in question, and open your favorite web browser. Gebruik de onderstaande aanvraag-Url's om te controleren of de container wordt uitgevoerd.Use the various request URLs below to validate the container is running. De onderstaande voorbeeld aanvraag-Url's zijn http://localhost:5000 , maar uw specifieke container kan variëren.The example request URLs listed below are http://localhost:5000, but your specific container may vary. Houd er rekening mee dat u afhankelijk bent van het externe IP- adres van uw container en de weer gegeven poort.Keep in mind that you're to rely on your container's External IP address and exposed port.

Aanvraag-URLRequest URL FunctiePurpose
http://localhost:5000/ De container bevat een start pagina.The container provides a home page.
http://localhost:5000/ready Met GET heeft dit een verificatie dat de container gereed is voor het accepteren van een query op het model.Requested with GET, this provides a verification that the container is ready to accept a query against the model. Deze aanvraag kan worden gebruikt voor Kubernetes- en gereedheids tests.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/status Daarnaast wordt met GET gevraagd of de API-sleutel die wordt gebruikt om de container te starten, geldig is zonder dat dit een eindpunt query veroorzaakt.Also requested with GET, this verifies if the api-key used to start the container is valid without causing an endpoint query. Deze aanvraag kan worden gebruikt voor Kubernetes- en gereedheids tests.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/swagger De container bevat een volledige documentatie voor de eind punten en een try- out -functie.The container provides a full set of documentation for the endpoints and a Try it out feature. Met deze functie kunt u uw instellingen invoeren in een HTML-formulier op het web en de query maken zonder dat u code hoeft te schrijven.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. Nadat de query is geretourneerd, wordt een voor beeld van een krul opdracht weer gegeven om te demonstreren welke HTTP-headers en hoofdtekst indeling vereist zijn.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

Start pagina van container

De container stoppenStop the container

Als u de container wilt afsluiten, selecteert u in de opdracht regel omgeving waar de container wordt uitgevoerd, CTRL + C.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.

ProbleemoplossingTroubleshooting

Wanneer u de container start of uitvoert, kunnen er problemen optreden.When starting or running the container, you may experience issues. Gebruik een uitvoer koppeling en schakel logboek registratie in.Use an output mount and enable logging. Als u dit doet, kan de container logboek bestanden genereren die handig zijn bij het oplossen van problemen.Doing so will allow the container to generate log files that are helpful when troubleshooting issues.

Tip

Zie Cognitive Services containers Veelgestelde vragen (FAQ)voor meer informatie en richt lijnen voor probleem oplossing.For more troubleshooting information and guidance, see Cognitive Services containers frequently asked questions (FAQ).

BillingBilling

De spraak containers verzenden facturerings gegevens naar Azure met behulp van een spraak bron op uw Azure-account.The Speech containers send billing information to Azure, using a Speech resource on your Azure account.

Query's naar de container worden gefactureerd op de prijs categorie van de Azure-resource die wordt gebruikt ApiKeyvoor de.Queries to the container are billed at the pricing tier of the Azure resource that's used for the ApiKey.

Azure Cognitive Services-containers mogen niet worden uitgevoerd zonder dat ze zijn verbonden met het eind punt voor meting/facturering.Azure Cognitive Services containers aren't licensed to run without being connected to the metering / billing endpoint. U moet de containers in staat stellen om de facturerings gegevens te allen tijde te communiceren met het eind punt.You must enable the containers to communicate billing information with the billing endpoint at all times. Cognitive Services containers verzenden geen klant gegevens, zoals de afbeelding of de tekst die wordt geanalyseerd, naar micro soft.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

Verbinding maken met AzureConnect to Azure

De voor de container vereiste facturerings argument waarden moeten worden uitgevoerd.The container needs the billing argument values to run. Met deze waarden kan de container verbinding maken met het eind punt van de facturering.These values allow the container to connect to the billing endpoint. De container rapporteert het gebruik ongeveer elke 10 tot 15 minuten.The container reports usage about every 10 to 15 minutes. Als de container geen verbinding maakt met Azure binnen het toegestane tijd venster, blijft de container actief, maar worden er geen query's verwerkt totdat het eind punt van de facturering is hersteld.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. De verbinding wordt 10 keer in hetzelfde tijds interval van 10 tot 15 minuten uitgevoerd.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Als er geen verbinding kan worden gemaakt met het facturerings eindpunt binnen de 10 pogingen, stopt de container met het door sturen van aanvragen.If it can't connect to the billing endpoint within the 10 tries, the container stops serving requests.

Facturerings argumentenBilling arguments

Met docker run de opdracht wordt de container gestart wanneer de drie van de volgende opties zijn voorzien van geldige waarden:The docker run command will start the container when all three of the following options are provided with valid values:

OptieOption BeschrijvingDescription
ApiKey De API-sleutel van de Cognitive Services resource die wordt gebruikt voor het bijhouden van facturerings gegevens.The API key of the Cognitive Services resource that's used to track billing information.
De waarde van deze optie moet worden ingesteld op een API-sleutel voor de ingerichte resource die is opgegeven in Billing.The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
Billing Het eind punt van de Cognitive Services resource die wordt gebruikt voor het bijhouden van facturerings gegevens.The endpoint of the Cognitive Services resource that's used to track billing information.
De waarde van deze optie moet worden ingesteld op de eindpunt-URI van een ingerichte Azure-resource.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
Eula Geeft aan dat u de licentie voor de container hebt geaccepteerd.Indicates that you accepted the license for the container.
De waarde van deze optie moet worden ingesteld op accepteren.The value of this option must be set to accept.

Zie containers configurerenvoor meer informatie over deze opties.For more information about these options, see Configure containers.

BlogberichtenBlog posts

Voorbeelden voor ontwikkelaarsDeveloper samples

Voor beelden van ontwikkel aars zijn beschikbaar in onze github-opslag plaats.Developer samples are available at our GitHub repository.

Webinar weer gevenView webinar

Doe mee aan de webinar voor meer informatie over:Join the webinar to learn about:

  • Cognitive Services op elke machine implementeren met behulp van dockerHow to deploy Cognitive Services to any machine using Docker
  • Cognitive Services implementeren op AKSHow to deploy Cognitive Services to AKS

SamenvattingSummary

In dit artikel hebt u concepten en werk stromen geleerd om spraak containers te downloaden, te installeren en uit te voeren.In this article, you learned concepts and workflow for downloading, installing, and running Speech containers. Samenvatting:In summary:

  • Spraak biedt vier Linux-containers voor docker, die verschillende mogelijkheden inkapselen:Speech provides four Linux containers for Docker, encapsulating various capabilities:
    • Spraak naar tekstSpeech-to-text
    • Custom Speech-naar-tekstCustom Speech-to-text
    • Tekst naar spraakText-to-speech
    • Aangepaste tekst-naar-spraakCustom Text-to-speech
  • Container installatie kopieën worden gedownload uit het container register in Azure.Container images are downloaded from the container registry in Azure.
  • Container installatie kopieën worden uitgevoerd in docker.Container images run in Docker.
  • Of u de REST API (alleen tekst naar spraak) of de SDK (spraak naar tekst of tekst naar spraak) wilt gebruiken, geeft u de URI van de host op.Whether using the REST API (Text-to-speech only) or the SDK (Speech-to-text or Text-to-speech) you specify the host URI of the container.
  • U moet facturerings gegevens opgeven bij het instantiëren van een container.You're required to provide billing information when instantiating a container.

Belangrijk

Cognitive Services-containers mogen niet worden uitgevoerd zonder te zijn verbonden met Azure voor meting.Cognitive Services containers are not licensed to run without being connected to Azure for metering. Klanten moeten de containers in staat stellen om de facturerings gegevens te allen tijde met de meet service te communiceren.Customers need to enable the containers to communicate billing information with the metering service at all times. Cognitive Services containers verzenden geen klant gegevens (zoals de afbeelding of tekst die wordt geanalyseerd) naar micro soft.Cognitive Services containers do not send customer data (e.g., the image or text that is being analyzed) to Microsoft.

Volgende stappenNext steps