Installera och köra Docker-containrar för Speech-tjänstens API:erInstall and run Docker containers for the Speech service APIs

Med containrar kan du köra vissa Speech-tjänst-API:er i din egen miljö.Containers enable you to run some of the Speech service APIs in your own environment. Containrar är bra för specifika säkerhets- och datastyrningskrav.Containers are great for specific security and data governance requirements. I den här artikeln får du lära dig om hur du laddar ned, installerar och kör en Speech-container.In this article you'll learn how to download, install, and run a Speech container.

Speech-containrar gör det möjligt för kunder att bygga en arkitektur för talprogram som är optimerad för både robusta molnfunktioner och gränslokalitet.Speech containers enable customers to build a speech application architecture that is optimized for both robust cloud capabilities and edge locality. Det finns flera tillgängliga containrar som använder samma priser som de molnbaserade Azure Speech Services.There are several containers available, which use the same pricing as the cloud-based Azure Speech Services.

Viktigt

Följande Speech-containrar är nu allmänt tillgängliga:The following Speech containers are now Generally available:

  • Standard tal till textStandard Speech-to-text
  • Anpassat tal till textCustom Speech-to-text
  • Standardtext till talStandard Text-to-speech
  • Neural text till talNeural Text-to-speech

Följande speech-containrar finns i en gated preview (grindförhandsvisning).The following speech containers are in gated preview.

  • Speech SpråkidentifieringSpeech Language Detection

Om du vill använda speech-containrarna måste du skicka en onlinebegäran och få den godkänd.To use the speech containers you must submit an online request, and have it approved. Mer information finns i avsnittet Begär godkännande för att köra containern nedan.See the Request approval to the run the container section below for more information.

ContainerContainer FunktionerFeatures SenastLatest
Tal till textSpeech-to-text Analyserar sentiment och transkriberar kontinuerliga tal- eller batchljudinspelningar i realtid med mellanliggande resultat.Analyzes sentiment and transcribes continuous real-time speech or batch audio recordings with intermediate results. 2.11.02.11.0
Anpassat tal till textCustom Speech-to-text Med hjälp av en anpassad modell från Custom Speech-portalentranskriberar du kontinuerliga talinspelningar i realtid eller batchljudinspelningar till text med mellanliggande resultat.Using a custom model from the Custom Speech portal, transcribes continuous real-time speech or batch audio recordings into text with intermediate results. 2.11.02.11.0
Text till talText-to-speech Konverterar text till naturligt tal med oformaterad textinmatning eller Speech Synthesis Markup Language (SSML).Converts text to natural-sounding speech with plain text input or Speech Synthesis Markup Language (SSML). 1.13.01.13.0
Speech SpråkidentifieringSpeech Language Detection Identifiera språket som talas i ljudfiler.Detect the language spoken in audio files. 1.01.0
Neural text till talNeural Text-to-speech Konverterar text till naturligt ljudande tal med djup neural nätverksteknik, vilket möjliggör mer naturligt syntetiserat tal.Converts text to natural-sounding speech using deep neural network technology, allowing for more natural synthesized speech. 1.5.01.5.0

Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.If you don't have an Azure subscription, create a free account before you begin.

FörutsättningarPrerequisites

Följande krav måste vara uppfyllda innan du använder Speech-containrar:The following prerequisites before using Speech containers:

ObligatoriskRequired SyftePurpose
Docker-motornDocker Engine Docker-motorn måste vara installerad på en värddator.You need the Docker Engine installed on a host computer. Docker innehåller paket som konfigurerar Docker-miljön på macOS, Windows och Linux.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. En introduktion till grunderna för Docker och containrar finns i Docker-översikt.For a primer on Docker and container basics, see the Docker overview.

Docker måste konfigureras så att containrarna kan ansluta till och skicka faktureringsdata till Azure.Docker must be configured to allow the containers to connect with and send billing data to Azure.

I Windows måste Docker också konfigureras för att stödja Linux-containrar.On Windows, Docker must also be configured to support Linux containers.

Kunskaper om DockerFamiliarity with Docker Du bör ha en grundläggande förståelse för Docker-begrepp som register, lagringsdatabaser, containrar och containeravbildningar, samt kunskaper om grundläggande docker kommandon.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-resursSpeech resource För att kunna använda dessa containrar måste du ha:In order to use these containers, you must have:

En Azure Speech-resurs för att hämta den associerade API-nyckeln och slutpunkts-URI:n.An Azure Speech resource to get the associated API key and endpoint URI. Båda värdena är tillgängliga på Azure Portal på sidorna Talöversikt och Nycklar.Both values are available on the Azure portal's Speech Overview and Keys pages. Båda krävs för att starta containern.They are both required to start the container.

{API_KEY}: En av de två tillgängliga resursnycklarna på sidan Nycklar{API_KEY}: One of the two available resource keys on the Keys page

{ENDPOINT_URI}: Slutpunkten som anges på översiktssidan{ENDPOINT_URI}: The endpoint as provided on the Overview page

Nödvändiga parametrar samlas inGathering required parameters

Det finns tre primära parametrar för alla Cognitive Services behållare som krävs.There are three primary parameters for all Cognitive Services' containers that are required. Licens avtalet för slutanvändare (EULA) måste vara närvarande med värdet accept .The end-user license agreement (EULA) must be present with a value of accept. Dessutom behövs både en slut punkts-URL och API-nyckel.Additionally, both an Endpoint URL and API Key are needed.

Slut punkts-URI {ENDPOINT_URI}Endpoint URI {ENDPOINT_URI}

URI-värdet för slut punkten är tillgängligt på sidan Azure Portal Översikt för motsvarande kognitiva tjänst resurs.The Endpoint URI value is available on the Azure portal Overview page of the corresponding Cognitive Service resource. Gå till sidan Översikt , Hovra över slut punkten och en Copy to clipboard ikon visas.Navigate to the Overview page, hover over the Endpoint, and a Copy to clipboard icon will appear. Kopiera och använd vid behov.Copy and use where needed.

Samla in slut punkts-URI för senare användning

Nyckel {API_KEY}Keys {API_KEY}

Den här nyckeln används för att starta behållaren och är tillgänglig på sidan Azure Portals nycklar för motsvarande kognitiva tjänst resurser.This key is used to start the container, and is available on the Azure portal's Keys page of the corresponding Cognitive Service resource. Gå till sidan nycklar och klicka på Copy to clipboard ikonen.Navigate to the Keys page, and click on the Copy to clipboard icon.

Hämta en av de två nycklarna för senare användning

Viktigt

Dessa prenumerations nycklar används för att få åtkomst till ditt kognitiva tjänst-API.These subscription keys are used to access your Cognitive Service API. Dela inte dina nycklar.Do not share your keys. Lagra dem på ett säkert sätt, till exempel med hjälp av Azure Key Vault.Store them securely, for example, using Azure Key Vault. Vi rekommenderar också att du återskapar nycklarna regelbundet.We also recommend regenerating these keys regularly. Endast en nyckel krävs för att göra ett API-anrop.Only one key is necessary to make an API call. När du återskapar den första nyckeln kan du använda den andra nyckeln för fortsatt åtkomst till tjänsten.When regenerating the first key, you can use the second key for continued access to the service.

VärddatornThe host computer

Värden är en x64-baserad dator som kör Docker-behållaren.The host is a x64-based computer that runs the Docker container. Det kan vara en dator på din lokala dator eller en Docker-värd tjänst i Azure, till exempel:It can be a computer on your premises or a Docker hosting service in Azure, such as:

Stöd för avancerat vektortilläggAdvanced Vector Extension support

Värden är den dator som kör Docker-containern.The host is the computer that runs the docker container. Värden måste ha stöd för Advanced Vector Extensions (AVX2).The host must support Advanced Vector Extensions (AVX2). Du kan söka efter AVX2-stöd på Linux-värdar med följande kommando: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

Varning

Värddatorn krävs för att stödja AVX2.The host computer is required to support AVX2. Containern fungerar inte korrekt utan stöd för AVX2.The container will not function correctly without AVX2 support.

Krav och rekommendationer för containrarContainer requirements and recommendations

I följande tabell beskrivs den lägsta och rekommenderade allokeringen av resurser för varje Speech-container.The following table describes the minimum and recommended allocation of resources for each Speech container.

ContainerContainer MinimumMinimum RekommenderasRecommended
Tal till textSpeech-to-text 2 kärnor, 2 GB minne2 core, 2-GB memory 4 kärnor, 4 GB minne4 core, 4-GB memory
Anpassat tal till textCustom Speech-to-text 2 kärnor, 2 GB minne2 core, 2-GB memory 4 kärnor, 4 GB minne4 core, 4-GB memory
Text till talText-to-speech 1 kärna, 2 GB minne1 core, 2-GB memory 2 kärnor, 3 GB minne2 core, 3-GB memory
Speech SpråkidentifieringSpeech Language Detection 1 kärna, 1 GB minne1 core, 1-GB memory 1 kärna, 1 GB minne1 core, 1-GB memory
Neural text till talNeural Text-to-speech 6 kärnor, 12 GB minne6 core, 12-GB memory 8 kärnor, 16 GB minne8 core, 16-GB memory
  • Varje kärna måste vara minst 2,6 gigahertz (GHz) eller snabbare.Each core must be at least 2.6 gigahertz (GHz) or faster.

Kärna och minne motsvarar inställningarna --cpus och , som används som en del av kommandot --memory docker run .Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

Anteckning

Den lägsta och rekommenderade gränsen baseras på Docker-gränser, inte värddatorns resurser.The minimum and recommended are based off of Docker limits, not the host machine resources. Till exempel mappar minnesmappning för tal till text-containrar delar av en stor språkmodell, och vi rekommenderar att hela filen får plats i minnet, vilket är ytterligare 4–6 GB.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. Dessutom kan den första körningen av någon av containrar ta längre tid, eftersom modeller är indelade i minnet.Also, the first run of either container may take longer, since models are being paged into memory.

Begära godkännande för att köra containernRequest approval to the run the container

Fyll i och skicka formuläret för begäran för att begära åtkomst till containern.Fill out and submit the request form to request access to the container.

Formuläret efterfrågar information om dig, ditt företag och användar scenariot som du använder behållaren för.The form requests information about you, your company, and the user scenario for which you'll use the container. När du har skickat formuläret granskar Azure Cognitive Services-teamet det och skickar ett meddelande till dig med ett beslut.After you submit the form, the Azure Cognitive Services team will review it and email you with a decision.

Viktigt

  • I formuläret måste du använda en e-postadress som är kopplad till ett Azure-prenumerations-ID.On the form, you must use an email address associated with an Azure subscription ID.
  • Den Azure-resurs som du använder för att köra behållaren måste ha skapats med det godkända Azure-prenumerations-ID: t.The Azure resource you use to run the container must have been created with the approved Azure subscription ID.
  • Kontrol lera din e-postadress (både Inkorgen och skräppostmappen) för uppdateringar av status för ditt program från Microsoft.Check your email (both inbox and junk folders) for updates on the status of your application from Microsoft.

När du har godkänt kan du köra behållaren efter att ha laddat ned den från Microsoft Container Registry (MCR), som beskrivs längre fram i artikeln.After you're approved, you will be able to run the container after downloading it from the Microsoft Container Registry (MCR), described later in the article.

Du kommer inte att kunna köra behållaren om din Azure-prenumeration inte har godkänts.You won't be able to run the container if your Azure subscription has not been approved.

Hämta containeravbildningen med docker pullGet the container image with docker pull

Containeravbildningar för Speech finns i följande Container Registry.Container images for Speech are available in the following Container Registry.

ContainerContainer LagringsplatsRepository
Tal till textSpeech-to-text mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:latest

Tips

Du kan använda kommandot Docker images för att visa en lista över hämtade behållar avbildningar.You can use the docker images command to list your downloaded container images. Följande kommando visar till exempel ID, lagrings plats och tagg för varje Hämtad behållar avbildning, formaterad som en tabell: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 för Speech-containrarnaDocker pull for the Speech containers

Docker-pull för tal till text-containernDocker pull for the Speech-to-text container

Använd kommandot docker pull för att ladda ned en containeravbildning från Microsoft Container Registry.Use the docker pull command to download a container image from Microsoft Container registry.

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

Viktigt

Taggen latest hämtar en-US språk.The latest tag pulls the en-US locale. Ytterligare språk finns i Tal till text-språk.For additional locales see Speech-to-text locales.

Tal till text-språkSpeech-to-text locales

Alla taggar, förutom latest är i följande format och är fallkänsliga:All tags, except for latest are in the following format and are case-sensitive:

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

Följande tagg är ett exempel på formatet:The following tag is an example of the format:

2.6.0-amd64-en-us

Alla språk som stöds för tal till text-containern finns i Bildtaggar förtal till text.For all of the supported locales of the speech-to-text container, please see Speech-to-text image tags.

Så här använder du containernHow to use the container

När containern finns på värddatornanvänder du följande process för att arbeta med containern.Once the container is on the host computer, use the following process to work with the container.

  1. Kör containernmed de faktureringsinställningar som krävs.Run the container, with the required billing settings. Fler exempeldocker run kommandot är tillgängliga.More examples of the docker run command are available.
  2. Fråga containerns förutsägelseslutpunkt.Query the container's prediction endpoint.

Kör containern med docker runRun the container with docker run

Använd kommandot docker run för att köra containern.Use the docker run command to run the container. Information om hur du hämtar värdena och finns i samla in obligatoriska {Endpoint_URI} {API_Key} parametrar.Refer to gathering required parameters for details on how to get the {Endpoint_URI} and {API_Key} values. Ytterligare exempeldocker run kommandot är också tillgängliga.Additional examples of the docker run command are also available.

Kör standardcontainern tal till text genom att köra följande docker run kommando.To run the Standard Speech-to-text container, execute the following docker run command.

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

Det här kommandot:This command:

  • Kör en tal till text-container från containeravbildningen.Runs a Speech-to-text container from the container image.
  • Allokerar 4 PROCESSORkärnor och 4 GB minne.Allocates 4 CPU cores and 4 gigabytes (GB) of memory.
  • Exponerar TCP-port 5000 och allokerar en pseudo-TTY för containern.Exposes TCP port 5000 and allocates a pseudo-TTY for the container.
  • Tar automatiskt bort containern när den avslutas.Automatically removes the container after it exits. Containeravbildningen är fortfarande tillgänglig på värddatorn.The container image is still available on the host computer.

Anteckning

Containrar stöder komprimerade ljudindata till Speech SDK med hjälp av GStreamer.Containers support compressed audio input to Speech SDK using GStreamer. Om du vill installera GStreamer i en container följer du Linux-instruktionerna för GStreamer i Use codec compressed audio input with the Speech SDK (Använda codec-komprimerade ljudindata med Speech SDK).To install GStreamer in a container, follow Linux instructions for GStreamer in Use codec compressed audio input with the Speech SDK.

Diarisering av tal till text-utdataDiarization on the speech-to-text output

Diarisering är aktiverat som standard.Diarization is enabled by default. om du vill få diarisering i svaret använder du diarize_speech_config.set_service_property .to get diarization in your response, use diarize_speech_config.set_service_property.

  1. Ange formatet för frasutdata till Detailed .Set the phrase output format to Detailed.
  2. Ange diariseringsläge.Set the mode of diarization. Lägena som stöds Identity är och Anonymous .The supported modes are Identity and Anonymous.
diarize_speech_config.set_service_property(
    name='speechcontext-PhraseOutput.Format',
    value='Detailed',
    channel=speechsdk.ServicePropertyChannel.UriQueryParameter
)

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

Anteckning

"Identity"-läget "SpeakerId": "Customer" returnerar eller "SpeakerId": "Agent" ."Identity" mode returns "SpeakerId": "Customer" or "SpeakerId": "Agent". Läget "Anonym" "SpeakerId": "Speaker 1" returnerar eller "SpeakerId": "Speaker 2""Anonymous" mode returns "SpeakerId": "Speaker 1" or "SpeakerId": "Speaker 2"

Analysera sentiment i tal till text-utdataAnalyze sentiment on the speech-to-text output

Från och med v2.6.0 i tal till text-containern bör du använda TextAnalytics 3.0 API-slutpunkten i stället för förhandsversionen.Starting in v2.6.0 of the speech-to-text container, you should use TextAnalytics 3.0 API endpoint instead of the preview one. Till exempelFor example

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

Anteckning

API:Textanalys v3.0 är inte bakåtkompatibel med Textanalys v3.0-preview.1 .The Text Analytics v3.0 API is not backward compatible with Text Analytics v3.0-preview.1. För att få det senaste stödet för sentimentfunktionen använder v2.6.0 du containeravbildningen tal till text och Textanalys v3.0 .To get the latest sentiment feature support, use v2.6.0 of the speech-to-text container image and Text Analytics v3.0.

Från och med v2.2.0 i tal till text-containern kan du anropa API:et för attitydanalys v3 för utdata.Starting in v2.2.0 of the speech-to-text container, you can call the sentiment analysis v3 API on the output. Om du vill anropa attitydanalys behöver du en Textanalys API-resursslutpunkt.To call sentiment analysis, you will need a Text Analytics API resource endpoint. Exempel: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

Om du använder en slutpunkt för textanalys i molnet behöver du en nyckel.If you're accessing a Text analytics endpoint in the cloud, you will need a key. Om du kör en Textanalys lokalt kanske du inte behöver ange detta.If you're running Text Analytics locally, you may not need to provide this.

Nyckeln och slutpunkten skickas till Speech-containern som argument, som i följande exempel.The key and endpoint are passed to the Speech container as arguments, as in the following example.

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

Det här kommandot:This command:

  • Utför samma steg som kommandot ovan.Performs the same steps as the command above.
  • Lagrar en Textanalys API-slutpunkt och nyckel för att skicka sentimentanalysbegäranden.Stores a Text Analytics API endpoint and key, for sending sentiment analysis requests.

Phraselist v2 i tal till text-utdataPhraselist v2 on the speech-to-text output

Från och med v2.6.0 i tal-till-text-containern kan du hämta utdata med dina egna fraser – hela meningen eller fraser i mitten.Starting in v2.6.0 of the speech-to-text container, you can get the output with your own phrases - either the whole sentence, or phrases in the middle. Till exempel den långa människan i följande mening:For example the tall man in the following sentence:

  • "Det här är en mening, den långa människan, det här är en annan mening.""This is a sentence the tall man this is another sentence."

Om du vill konfigurera en fraslista måste du lägga till egna fraser när du gör anropet.To configure a phrase list, you need to add your own phrases when you make the call. Exempel:For example:

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

Om du har flera fraser att lägga till anropar du .addPhrase() för varje fras för att lägga till den i fraslistan.If you have multiple phrases to add, call .addPhrase() for each phrase to add it to the phrase list.

Viktigt

Alternativen Eula Billing , och måste anges för att ApiKey köra containern. Annars startar inte containern.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Mer information finns i Fakturering.For more information, see Billing.

Köra frågor mot containerns förutsägelseslutpunktQuery the container's prediction endpoint

Anteckning

Använd ett unikt portnummer om du kör flera containrar.Use a unique port number if you're running multiple containers.

ContainersContainers SDK-värd-URLSDK Host URL ProtokollProtocol
Standard tal till text och anpassat tal till textStandard Speech-to-text and Custom Speech-to-text ws://localhost:5000 WSWS
Text till tal (inklusive standard och neural), talspråksidentifieringText-to-speech (including Standard and Neural), Speech Language detection http://localhost:5000 HTTPHTTP

Mer information om hur du använder WSS- och HTTPS-protokoll finns i containersäkerhet.For more information on using WSS and HTTPS protocols, see container security.

Tal till text (standard och anpassad)Speech-to-text (Standard and Custom)

Behållaren tillhandahåller WebSocket-baserade frågor för slut punkts-API: er som nås via tal-SDK: n.The container provides websocket-based query endpoint APIs, that are accessed through the Speech SDK. Som standard använder tal-SDK online Speech Services.By default, the Speech SDK uses online speech services. Om du vill använda behållaren måste du ändra initierings metoden.To use the container, you need to change the initialization method.

Tips

När du använder tal-SDK med behållare behöver du inte ange resurs prenumerations nyckeln för Azure tal eller en token för autentisering.When using the Speech SDK with containers, you do not need to provide the Azure Speech resource subscription key or an authentication bearer token.

Se exemplen nedan.See the examples below.

Ändra från att använda det här Azure-moln initierings anropet:Change from using this Azure-cloud initialization call:

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

Använda det här anropet med behållar värden:To using this call with the container host:

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

Analysera sentimentAnalyze sentiment

Om du har angett Textanalys API-autentiseringsuppgifter till containernkan du använda Speech SDK för att skicka taligenkänningsbegäranden med attitydanalys.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. Du kan konfigurera API-svaren så att de använder antingen ett enkelt eller detaljerat format.You can configure the API responses to use either a simple or detailed format.

Anteckning

v1.13 i Speech Service Python SDK har ett identifierat problem med attitydanalys.v1.13 of the Speech Service Python SDK has an identified issue with sentiment analysis. Använd v1.12.x eller tidigare om du använder attitydanalys i Speech Service Python SDK.Please use v1.12.x or earlier if you're using sentiment analysis in the Speech Service Python SDK.

Om du vill konfigurera Speech-klienten så att den använder ett enkelt format lägger "Sentiment" du till som ett värde för Simple.Extensions .To configure the Speech client to use a simple format, add "Sentiment" as a value for Simple.Extensions. Om du vill välja en specifik Textanalys modellversion ersätter du 'latest' i speechcontext-phraseDetection.sentimentAnalysis.modelversion egenskapskonfigurationen.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.Extensions returnerar sentimentresultatet i svarsrotskiktet.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
   }
}

Om du vill inaktivera attitydanalys helt lägger du till false ett värde i 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
)

Text till tal (standard och neural)Text-to-speech (Standard and Neural)

Containern tillhandahåller REST-baserade slutpunkts-API:er.The container provides REST-based endpoint APIs. Det finns många exempel på källkodsprojekt för plattforms-, ramverks- och språkvariationer.There are many sample source code projects for platform, framework, and language variations available.

Med standardcontainrar eller containrar för neural text till tal bör du förlita dig på språk och röst för den bildtagg som du laddade ned.With the Standard or Neural Text-to-speech containers, you should rely on the locale and voice of the image tag you downloaded. Om du till exempel laddade ned latest taggen är standardspråket en-US och AriaNeural rösten.For example, if you downloaded the latest tag the default locale is en-US and the AriaNeural voice. Argumentet {VOICE_NAME} skulle då vara en-US-AriaNeural .The {VOICE_NAME} argument would then be en-US-AriaNeural. Se SSML-exemplet nedan:See the example SSML below:

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

Köra flera containrar på samma värdRun multiple containers on the same host

Om du tänker köra flera containrar med exponerade portar ska du se till att köra varje container med en annan exponerad port.If you intend to run multiple containers with exposed ports, make sure to run each container with a different exposed port. Kör till exempel den första containern på port 5000 och den andra containern på port 5001.For example, run the first container on port 5000 and the second container on port 5001.

Du kan ha den här containern och Azure Cognitive Services en annan container som körs på VÄRDEN tillsammans.You can have this container and a different Azure Cognitive Services container running on the HOST together. Du kan också ha flera containrar i samma Cognitive Services som körs.You also can have multiple containers of the same Cognitive Services container running.

Verifiera att en behållare körsValidate that a container is running

Det finns flera sätt att verifiera att behållaren körs.There are several ways to validate that the container is running. Leta reda på den externa IP- adressen och den exponerade porten för den aktuella behållaren och öppna din favorit webbläsare.Locate the External IP address and exposed port of the container in question, and open your favorite web browser. Använd de olika URL: erna för begäran nedan för att verifiera att behållaren körs.Use the various request URLs below to validate the container is running. URL: erna för exempel begär Anden som anges nedan är http://localhost:5000 , men din speciella behållare kan variera.The example request URLs listed below are http://localhost:5000, but your specific container may vary. Tänk på att du är beroende av behållarens externa IP -adress och exponerad port.Keep in mind that you're to rely on your container's External IP address and exposed port.

URL för begäranRequest URL SyftePurpose
http://localhost:5000/ Containern tillhandahåller en startsida.The container provides a home page.
http://localhost:5000/ready Begärd med GET, detta ger en verifiering av att behållaren är redo att acceptera en fråga mot modellen.Requested with GET, this provides a verification that the container is ready to accept a query against the model. Den här begäran kan användas för Kubernetes Live och beredskaps avsökningar.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/status Begärd med GET, kontrollerar detta om den API-nyckel som används för att starta behållaren är giltig utan att orsaka en slut punkts fråga.Also requested with GET, this verifies if the api-key used to start the container is valid without causing an endpoint query. Den här begäran kan användas för Kubernetes Live och beredskaps avsökningar.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/swagger Containern tillhandahåller en fullständig uppsättning dokumentation för slutpunkterna samt en Prova-funktion.The container provides a full set of documentation for the endpoints and a Try it out feature. Med den här funktionen kan du ange dina inställningar i ett webbaserat HTML-formulär och göra frågan utan att behöva skriva någon kod.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. När frågan returnerar visas ett exempel på ett spiral kommando som visar de HTTP-rubriker och det text format som krävs.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

Behållarens start sida

Stoppa containernStop the container

Om du vill stänga av behållaren går du till kommando rads miljön där behållaren körs och väljer CTRL + C.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.

FelsökningTroubleshooting

När du startar eller kör containern kan det uppstå problem.When starting or running the container, you may experience issues. Använd en utdatamontering och aktivera loggning.Use an output mount and enable logging. Om du gör det kan containern generera loggfiler som är användbara vid felsökning av problem.Doing so will allow the container to generate log files that are helpful when troubleshooting issues.

Tips

Mer felsöknings information och vägledning finns i Cognitive Services behållare vanliga frågor och svar.For more troubleshooting information and guidance, see Cognitive Services containers frequently asked questions (FAQ).

FaktureringBilling

Speech-containrarna skickar faktureringsinformation till Azure med hjälp av en Speech-resurs på ditt Azure-konto.The Speech containers send billing information to Azure, using a Speech resource on your Azure account.

Frågor till behållaren debiteras enligt pris nivån för den Azure-resurs som används för ApiKey .Queries to the container are billed at the pricing tier of the Azure resource that's used for the ApiKey.

Azure Cognitive Services-behållare är inte licensierade för att köras utan att vara anslutna till avläsnings-/fakturerings slut punkten.Azure Cognitive Services containers aren't licensed to run without being connected to the metering / billing endpoint. Du måste göra det möjligt för behållarna att kommunicera fakturerings information med fakturerings slut punkten hela tiden.You must enable the containers to communicate billing information with the billing endpoint at all times. Cognitive Services behållare skickar inte kund information, till exempel den bild eller text som analyseras, till Microsoft.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

Anslut till AzureConnect to Azure

Containern behöver de fakturerings argument värden som ska köras.The container needs the billing argument values to run. Dessa värden tillåter att behållaren ansluter till fakturerings slut punkten.These values allow the container to connect to the billing endpoint. Behållar rapporteringen visar var 10 till 15: e minut.The container reports usage about every 10 to 15 minutes. Om behållaren inte ansluter till Azure inom den tillåtna tids perioden fortsätter behållaren att köras men hanterar inte frågor förrän fakturerings slut punkten återställs.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. Anslutnings försöket görs 10 gånger med samma tidsintervall 10 till 15 minuter.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Om den inte kan ansluta till fakturerings slut punkten inom 10 försök slutar behållaren att betjäna begär Anden.If it can't connect to the billing endpoint within the 10 tries, the container stops serving requests. Se vanliga frågor och svar om Cognitive Services container för att få ett exempel på den information som skickas till Microsoft för fakturering.See the Cognitive Services container FAQ for an example of the information sent to Microsoft for billing.

Fakturerings argumentBilling arguments

docker run Kommandot startar behållaren när alla tre av följande alternativ finns med giltiga värden :The docker run command will start the container when all three of the following options are provided with valid values:

AlternativOption BeskrivningDescription
ApiKey API-nyckeln för den Cognitive Services resurs som används för att spåra fakturerings information.The API key of the Cognitive Services resource that's used to track billing information.
Värdet för det här alternativet måste anges till en API-nyckel för den etablerade resurs som anges i Billing .The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
Billing Slut punkten för den Cognitive Services resursen som används för att spåra fakturerings information.The endpoint of the Cognitive Services resource that's used to track billing information.
Värdet för det här alternativet måste anges till slut punkts-URI för en etablerad Azure-resurs.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
Eula Anger att du har accepterat licensen för behållaren.Indicates that you accepted the license for the container.
Värdet för det här alternativet måste vara inställt på acceptera.The value of this option must be set to accept.

Mer information om dessa alternativ finns i Konfigurera containrar.For more information about these options, see Configure containers.

SammanfattningSummary

I den här artikeln har du lärt dig begrepp och arbetsflöden för att ladda ned, installera och köra Speech-containrar.In this article, you learned concepts and workflow for downloading, installing, and running Speech containers. Sammanfattningsvis:In summary:

  • Speech tillhandahåller fyra Linux-containrar för Docker som kapslar in olika funktioner:Speech provides four Linux containers for Docker, encapsulating various capabilities:
    • Tal till textSpeech-to-text
    • Anpassat tal till textCustom Speech-to-text
    • Text till talText-to-speech
    • Anpassad text till talCustom Text-to-speech
    • Neural text till talNeural Text-to-speech
    • Speech SpråkidentifieringSpeech Language Detection
  • Containeravbildningar laddas ned från containerregistret i Azure.Container images are downloaded from the container registry in Azure.
  • Containeravbildningar körs i Docker.Container images run in Docker.
  • Om du använder REST API (endast text till tal) eller SDK (tal till text eller text till tal) anger du värd-URI för containern.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.
  • Du måste ange faktureringsinformation när du instansierar en container.You're required to provide billing information when instantiating a container.

Viktigt

Cognitive Services-containrar är inte licensierade att köras utan att vara anslutna till Azure för mätning.Cognitive Services containers are not licensed to run without being connected to Azure for metering. Kunder måste göra det möjligt för containrarna att alltid kommunicera faktureringsinformation med mätningstjänsten.Customers need to enable the containers to communicate billing information with the metering service at all times. Cognitive Services-containrar skickar inte kunddata (t.ex. den bild eller text som analyseras) till Microsoft.Cognitive Services containers do not send customer data (e.g., the image or text that is being analyzed) to Microsoft.

Nästa stegNext steps