Installare ed eseguire i contenitori dei servizi vocali (anteprima)Install and run Speech service containers (Preview)

I contenitori consentono di eseguire alcune delle API del servizio vocale nell'ambiente in uso.Containers enable you to run some of the Speech service APIs in your own environment. I contenitori sono ottimi per requisiti specifici di sicurezza e governance dei dati.Containers are great for specific security and data governance requirements. In questo articolo si apprenderà come scaricare, installare ed eseguire un contenitore di riconoscimento vocale.In this article you'll learn how to download, install, and run a Speech container.

I contenitori di sintesi vocale consentono ai clienti di creare un'architettura di applicazione vocale ottimizzata per le funzionalità cloud affidabili e la località perimetrale.Speech containers enable customers to build a speech application architecture that is optimized for both robust cloud capabilities and edge locality. Sono disponibili quattro contenitori diversi.There are four different containers available. I due contenitori standard sono sintesi vocale e sintesi vocale.The two standard containers are Speech-to-text and Text-to-speech. I due contenitori personalizzati sono da riconoscimento vocale personalizzato a testo e da sintesi vocale personalizzata.The two custom containers are Custom Speech-to-text and Custom Text-to-speech.

Importante

Tutti i contenitori di riconoscimento vocale sono attualmente offerti come parte di un' anteprima pubblica "gestita".All speech containers are currently offered as part of a Public "Gated" Preview. Verrà creato un annuncio quando i contenitori di riconoscimento vocale sono in stato di disponibilità generale.An announcement will be made when speech containers progress to General Availability (GA).

FunzioneFunction database elasticoFeatures Più recenteLatest
Riconoscimento vocaleSpeech-to-text Trascrive registrazioni audio continue in tempo reale o batch in testo con risultati intermedi.Transcribes continuous real-time speech or batch audio recordings into text with intermediate results. 2.0.02.0.0
Da Riconoscimento vocale personalizzato a testoCustom Speech-to-text Usando un modello personalizzato dal portale di riconoscimento vocale personalizzato, le registrazioni audio continue in tempo reale o batch vengono trascritte in testo con risultati intermedi.Using a custom model from the Custom Speech portal, transcribes continuous real-time speech or batch audio recordings into text with intermediate results. 2.0.02.0.0
Sintesi vocaleText-to-speech Converte il testo in sintesi vocale naturale con input di testo normale o linguaggio di markup sintesi vocale (SSML).Converts text to natural-sounding speech with plain text input or Speech Synthesis Markup Language (SSML). 1.3.01.3.0
Sintesi vocale personalizzataCustom Text-to-speech Usando un modello personalizzato dal portale vocale personalizzato, converte il testo in un discorso di suono naturale con input di testo normale o SSML (Speech Synthesis 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.3.01.3.0

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

PrerequisitiPrerequisites

I prerequisiti seguenti prima di usare i contenitori di sintesi vocale:The following prerequisites before using Speech containers:

ObbligatorioRequired FinalitàPurpose
Motore DockerDocker Engine È necessario il motore Docker installato in un computer host.You need the Docker Engine installed on a host computer. Docker offre pacchetti per la configurazione dell'ambiente Docker in macOS, Windows e Linux.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. Per una panoramica dei concetti fondamentali relativi a Docker e ai contenitori, vedere Docker overview (Panoramica di Docker).For a primer on Docker and container basics, see the Docker overview.

Docker deve essere configurato per consentire ai contenitori di connettersi ai dati di fatturazione e inviarli ad Azure.Docker must be configured to allow the containers to connect with and send billing data to Azure.

In Windows Docker deve essere configurato anche per supportare i contenitori Linux.On Windows, Docker must also be configured to support Linux containers.

Familiarità con DockerFamiliarity with Docker È opportuno avere una conoscenza di base dei concetti relativi a Docker, tra cui registri, repository, contenitori e immagini dei contenitori, nonché dei comandi docker di base.You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.
Risorsa vocaleSpeech resource Per usare questi contenitori, è necessario avere:In order to use these containers, you must have:

Una risorsa vocale di Azure per ottenere la chiave API e l'URI dell'endpoint associati.An Azure Speech resource to get the associated API key and endpoint URI. Entrambi i valori sono disponibili nelle pagine relative alla panoramica e alle chiavi del discorso del portale di Azure.Both values are available on the Azure portal's Speech Overview and Keys pages. Sono entrambi necessari per avviare il contenitore.They are both required to start the container.

{API_KEY} : una delle due chiavi di risorsa disponibili nella pagina chiavi{API_KEY}: One of the two available resource keys on the Keys page

{ENDPOINT_URI} : endpoint fornito nella pagina Panoramica{ENDPOINT_URI}: The endpoint as provided on the Overview page

Richiedere l'accesso al registro contenitoriRequest access to the container registry

Compilare e inviare il modulo di richiesta di contenitori di sintesi vocale di servizi cognitivi per richiedere l'accesso al contenitore.Fill out and submit the Cognitive Services Speech Containers Request form to request access to the container.

Il modulo richiede informazioni sull'utente, sull'azienda e sullo scenario utente per cui si userà il contenitore.The form requests information about you, your company, and the user scenario for which you'll use the container. Dopo l'invio del modulo, il team di Servizi cognitivi di Azure lo esaminerà per verificare che siano soddisfatti i criteri di accesso al registro contenitori privato.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.

Importante

È necessario usare un indirizzo di posta elettronica associato un account Microsoft o Azure Active Directory (Azure AD) nel modulo.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.

Se la richiesta viene approvata, si riceverà un messaggio di posta elettronica con istruzioni su come ottenere le credenziali e accedere al registro contenitori privato.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.

Usare l'interfaccia della riga di comando Docker per l'autenticazione del registro contenitori privatoUse the Docker CLI to authenticate the private container registry

È possibile eseguire l'autenticazione con il registro contenitori privato per i contenitori di Servizi cognitivi in diversi modi, ma il metodo da riga di comando consigliato consiste nell'usare l'interfaccia della riga di comando di Docker.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.

Usare il comando docker login, come illustrato nell'esempio seguente, per accedere a containerpreview.azurecr.io, il registro contenitori privato per i contenitori di Servizi cognitivi.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. Sostituire <username> con il nome utente e <password> con la password specificata nelle credenziali ricevute dal team di Servizi cognitivi di Azure.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>

Se le credenziali sono protette in un file di testo, è possibile concatenare il contenuto del file al comando docker login usando il comando cat, come mostrato nell'esempio seguente.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. Sostituire <passwordFile> con il percorso e il nome del file di testo contenente la password e <username> con il nome utente specificato nelle credenziali.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

Raccolta dei parametri obbligatoriGathering required parameters

Sono disponibili tre parametri primari per tutti i contenitori di servizi cognitivi richiesti.There are three primary parameters for all Cognitive Services' containers that are required. Il contratto di licenza con l'utente finale deve essere presente con il valore accept.The end-user license agreement (EULA) must be present with a value of accept. Sono inoltre necessari un URL dell'endpoint e una chiave API.Additionally, both an Endpoint URL and API Key are needed.

URI dell'endpoint {ENDPOINT_URI}Endpoint URI {ENDPOINT_URI}

Il valore dell'URI dell' endpoint è disponibile nella pagina Panoramica portale di Azure della risorsa del servizio cognitiva corrispondente.The Endpoint URI value is available on the Azure portal Overview page of the corresponding Cognitive Service resource. Passare alla pagina Panoramica , posizionare il puntatore del mouse sull'endpoint e verrà visualizzata un'icona Copy to clipboard.Navigate to the Overview page, hover over the Endpoint, and a Copy to clipboard icon will appear. Copiare e usare se necessario.Copy and use where needed.

Raccogliere l'URI dell'endpoint per un uso successivo

Chiavi {API_KEY}Keys {API_KEY}

Questa chiave viene usata per avviare il contenitore ed è disponibile nella pagina chiavi del portale di Azure della risorsa del servizio cognitiva corrispondente.This key is used to start the container, and is available on the Azure portal's Keys page of the corresponding Cognitive Service resource. Passare alla pagina chiavi e fare clic sull'icona Copy to clipboard .Navigate to the Keys page, and click on the Copy to clipboard icon.

Ottenere una delle due chiavi per un uso successivo

Importante

Queste chiavi di sottoscrizione vengono usate per accedere all'API di servizi cognitivi.These subscription keys are used to access your Cognitive Service API. Non condividere le chiavi.Do not share your keys. Archiviarli in modo sicuro, ad esempio usando Azure Key Vault.Store them securely, for example, using Azure Key Vault. Si consiglia inoltre di rigenerare regolarmente queste chiavi.We also recommend regenerating these keys regularly. È necessaria una sola chiave per effettuare una chiamata API.Only one key is necessary to make an API call. Quando si rigenera la prima chiave, è possibile usare la seconda chiave per l'accesso continuo al servizio.When regenerating the first key, you can use the second key for continued access to the service.

Computer hostThe host computer

L'host è un computer basato su x64 che esegue il contenitore Docker.The host is a x64-based computer that runs the Docker container. Può essere un computer dell'ambiente locale o un servizio di hosting Docker in Azure, tra cui:It can be a computer on your premises or a Docker hosting service in Azure, such as:

Supporto Advanced Vector ExtensionAdvanced Vector Extension support

L'host è il computer che esegue il contenitore Docker.The host is the computer that runs the docker container. L'host deve supportare Advanced Vector Extensions (AVX2).The host must support Advanced Vector Extensions (AVX2). È possibile verificare il supporto di AVX2 negli host Linux con il comando seguente: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

Avviso

Il computer host è necessario per supportare AVX2.The host computer is required to support AVX2. Il contenitore non funzionerà correttamente senza supporto per AVX2.The container will not function correctly without AVX2 support.

Indicazioni e requisiti per i contenitoriContainer requirements and recommendations

La tabella seguente descrive l'allocazione minima e consigliata delle risorse per ogni contenitore vocale.The following table describes the minimum and recommended allocation of resources for each Speech container.

ContenitoreContainer MinimaMinimum ConsigliatoRecommended
Riconoscimento vocaleSpeech-to-text 2 Core, 2 GB di memoria2 core, 2-GB memory 4 core, 4 GB di memoria4 core, 4-GB memory
  • Ogni core deve essere di almeno 2,6 gigahertz (GHz) o superiore.Each core must be at least 2.6 gigahertz (GHz) or faster.

Core e memoria corrispondono alle impostazioni --cpus e --memory che vengono usate come parte del comando docker run.Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

Nota

Il valore minimo e consigliato sono basati sui limiti di Docker, non sulle risorse del computer host.The minimum and recommended are based off of Docker limits, not the host machine resources. Ad esempio, i contenitori di sintesi vocale mappano parti di un modello di linguaggio di grandi dimensioni ed è consigliabile che l'intero file si trovi in memoria, che è un 4-6 GB aggiuntivo.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. Inoltre, la prima esecuzione di uno dei due contenitori potrebbe richiedere più tempo, perché i modelli vengono inseriti in una pagina di memoria.Also, the first run of either container may take longer, since models are being paged into memory.

Ottenere l'immagine del contenitore con docker pullGet the container image with docker pull

Le immagini del contenitore per la sintesi vocale sono disponibili nelle Container Registry seguenti.Container images for Speech are available in the following Container Registry.

ContenitoreContainer ArchivioRepository
Riconoscimento vocaleSpeech-to-text containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text:latest

Suggerimento

È possibile usare il comando docker images per visualizzare l'elenco delle immagini dei contenitori scaricate.You can use the docker images command to list your downloaded container images. Ad esempio, il comando seguente visualizza l'ID, il repository e il tag di ogni immagine del contenitore scaricata, in formato tabella: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>

Pull Docker per i contenitori di riconoscimento vocaleDocker pull for the Speech containers

Pull di Docker per il contenitore di riconoscimento vocaleDocker pull for the Speech-to-text container

Usare il comando Docker pull per scaricare un'immagine del contenitore dal registro di anteprima del contenitore.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

Importante

Il tag latest estrae le impostazioni locali del en-US.The latest tag pulls the en-US locale. Per altre impostazioni locali, vedere impostazioni locali di riconoscimento vocale.For additional locales see Speech-to-text locales.

Impostazioni locali per sintesi vocaleSpeech-to-text locales

Tutti i tag, ad eccezione di latest, sono nel formato seguente e fanno distinzione tra maiuscole e minuscole:All tags, except for latest are in the following format and are case-sensitive:

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

Il seguente tag è un esempio del formato:The following tag is an example of the format:

2.0.0-amd64-en-us-preview

Per tutte le impostazioni locali supportate del contenitore di riconoscimento vocale , vedere tag dell'immagine da voce a testo.For all of the supported locales of the speech-to-text container, please see Speech-to-text image tags.

Come usare il contenitoreHow to use the container

Dopo aver aggiunto il contenitore nel computer host, seguire questa procedura per usare il contenitore.Once the container is on the host computer, use the following process to work with the container.

  1. Eseguire il contenitore, con le impostazioni di fatturazione necessarie.Run the container, with the required billing settings. Sono disponibili altri esempi del comando docker run.More examples of the docker run command are available.
  2. Eseguire le query sull'endpoint di stima del contenitore.Query the container's prediction endpoint.

Eseguire il contenitore con docker runRun the container with docker run

Usare il comando docker run per eseguire il contenitore.Use the docker run command to run the container. Per informazioni dettagliate su come ottenere i valori {Endpoint_URI} e {API_Key}, vedere raccolta dei parametri obbligatori .Refer to gathering required parameters for details on how to get the {Endpoint_URI} and {API_Key} values. Sono disponibili anche esempi aggiuntivi del comando docker run.Additional examples of the docker run command are also available.

Per eseguire il contenitore sintesi vocale , eseguire il comando docker run seguente.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}

Questo comando:This command:

  • Esegue un contenitore di riconoscimento vocale dall'immagine del contenitore.Runs a Speech-to-text container from the container image.
  • Alloca 4 core CPU e 4 gigabyte (GB) di memoria.Allocates 4 CPU cores and 4 gigabytes (GB) of memory.
  • Espone la porta TCP 5000 e alloca un pseudo terminale TTY per il contenitore.Exposes TCP port 5000 and allocates a pseudo-TTY for the container.
  • Rimuove automaticamente il contenitore dopo la chiusura.Automatically removes the container after it exits. L'immagine del contenitore rimane disponibile nel computer host.The container image is still available on the host computer.

Importante

È necessario specificare le opzioni Eula, Billing e ApiKey per eseguire il contenitore. In caso contrario, il contenitore non si avvia.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Per altre informazioni, vedereFatturazione.For more information, see Billing.

Eseguire query sull'endpoint di stima del contenitoreQuery the container's prediction endpoint

ContenitoriContainers URL host SDKSDK Host URL ProtocolloProtocol
Riconoscimento vocale e da Riconoscimento vocale personalizzato a testoSpeech-to-text and Custom Speech-to-text ws://localhost:5000 WSWS
Sintesi vocale e sintesi vocale personalizzataText-to-speech and Custom Text-to-speech http://localhost:5000 HTTPHTTP

Per ulteriori informazioni sull'utilizzo di protocolli WSS e HTTPS, vedere sicurezza dei contenitori.For more information on using WSS and HTTPS protocols, see container security.

Riconoscimento vocale o da Riconoscimento vocale personalizzato a testoSpeech-to-text or Custom Speech-to-text

Il contenitore fornisce le API dell'endpoint di query basate su WebSocket, a cui si accede tramite l' SDK di riconoscimento vocale.The container provides websocket-based query endpoint APIs, that are accessed through the Speech SDK. Per impostazione predefinita, l'SDK vocale usa i servizi di riconoscimento vocale online.By default, the Speech SDK uses online speech services. Per usare il contenitore, è necessario modificare il metodo di inizializzazione.To use the container, you need to change the initialization method.

Suggerimento

Quando si usa l'SDK di riconoscimento vocale con i contenitori, non è necessario specificare la chiave di sottoscrizione della risorsa vocale di Azure o un Bearer token di autenticazione.When using the Speech SDK with containers, you do not need to provide the Azure Speech resource subscription key or an authentication bearer token.

Vedere gli esempi seguenti.See the examples below.

Passare dall'uso di questa chiamata di inizializzazione del cloud di Azure:Change from using this Azure-cloud initialization call:

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

a questa chiamata usando l' hostdel contenitore:to this call using the container host:

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

Sintesi vocale o sintesi vocale personalizzataText-to-speech or Custom Text-to-speech

Il contenitore fornisce API endpoint basate su REST.The container provides REST-based endpoint APIs. Sono disponibili molti progetti di codice sorgente di esempio per la piattaforma, il Framework e le varianti del linguaggio disponibili.There are many sample source code projects for platform, framework, and language variations available.

Con il contenitore di sintesi vocale standard , è consigliabile fare affidamento sulle impostazioni locali e sulla voce del tag di immagine scaricato.With the Standard Text-to-speech container, you should rely on the locale and voice of the image tag you downloaded. Ad esempio, se è stato scaricato il tag latest le impostazioni locali predefinite sono en-US e il JessaRUS voce.For example, if you downloaded the latest tag the default locale is en-US and the JessaRUS voice. Il {VOICE_NAME} argomento verrebbe quindi en-US-JessaRUS.The {VOICE_NAME} argument would then be en-US-JessaRUS. Vedere l'esempio di SSML di seguito: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>

Tuttavia, per la sintesi vocale personalizzata è necessario ottenere la voce o il modello dal portale vocale personalizzato.However, for Custom Text-to-speech you'll need to obtain the Voice / model from the custom voice portal. Il nome del modello personalizzato è sinonimo del nome della voce.The custom model name is synonymous with the voice name. Passare alla pagina Training e copiare la voce o il modello da usare come argomento {VOICE_NAME}.Navigate to the Training page, and copy the Voice / model to use as the {VOICE_NAME} argument.

Modello Voice personalizzato-nome vocale

Vedere l'esempio di SSML di seguito: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>

Viene ora creata una richiesta HTTP POST, che fornisce alcune intestazioni e un payload di dati.Let's construct an HTTP POST request, providing a few headers and a data payload. Sostituire il segnaposto {VOICE_NAME} con il proprio valore.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>'

Questo comando:This command:

  • Costruisce una richiesta HTTP POST per l'endpoint speech/synthesize/cognitiveservices/v1.Constructs an HTTP POST request for the speech/synthesize/cognitiveservices/v1 endpoint.
  • Specifica un'intestazione Accept di audio/*Specifies an Accept header of audio/*
  • Specifica un'intestazione Content-Type di application/ssml+xml. per ulteriori informazioni, vedere il corpo della richiesta.Specifies a Content-Type header of application/ssml+xml, for more information, see request body.
  • Specifica un'intestazione X-Microsoft-OutputFormat di riff-16khz-16bit-mono-pcm, per altre opzioni vedere output audio.Specifies a X-Microsoft-OutputFormat header of riff-16khz-16bit-mono-pcm, for more options see audio output.
  • Invia la richiesta SSML (Speech Synthesis Markup Language) data la {VOICE_NAME} all'endpoint.Sends the Speech Synthesis Markup Language (SSML) request given the {VOICE_NAME} to the endpoint.

Eseguire più contenitori nello stesso hostRun multiple containers on the same host

Se si intende eseguire più contenitori con porte esposte, assicurarsi di eseguire ogni contenitore con una porta esposta diversa.If you intend to run multiple containers with exposed ports, make sure to run each container with a different exposed port. Eseguire ad esempio il primo contenitore sulla porta 5000 e il secondo sulla porta 5001.For example, run the first container on port 5000 and the second container on port 5001.

Questo contenitore e un contenitore di Servizi cognitivi diverso sono in esecuzione contemporaneamente sull'HOST.You can have this container and a different Azure Cognitive Services container running on the HOST together. Sono inoltre in esecuzione più contenitori dello stesso contenitore di Servizi cognitivi.You also can have multiple containers of the same Cognitive Services container running.

Verificare che il contenitore sia in esecuzioneValidate that a container is running

Per verificare se il contenitore è in esecuzione, sono disponibili diverse opzioni.There are several ways to validate that the container is running. Individuare l'indirizzo IP esterno e la porta esposta del contenitore in questione e aprire il Web browser preferito.Locate the External IP address and exposed port of the container in question, and open your favorite web browser. Usare i vari URL di richiesta indicati di seguito per verificare che il contenitore sia in esecuzione.Use the various request URLs below to validate the container is running. Gli URL di richiesta di esempio elencati di seguito sono http://localhost:5000, ma il contenitore specifico può variare.The example request URLs listed below are http://localhost:5000, but your specific container may vary. Tenere presente che si sta per fare affidamento sull'indirizzo IP esterno del contenitore e sulla porta esposta.Keep in mind that you're to rely on your container's External IP address and exposed port.

URL richiestaRequest URL FinalitàPurpose
http://localhost:5000/ Il contenitore fornisce una home page.The container provides a home page.
http://localhost:5000/status Richiesta con HTTP GET, per verificare che il contenitore sia in esecuzione senza causare una query dell'endpoint.Requested with an HTTP GET, to validate that the container is running without causing an endpoint query. Questa richiesta può essere usata per i probe di attività e di idoneità di Kubernetes.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/swagger Il contenitore fornisce un set completo di documentazione per gli endpoint e una funzionalità di prova .The container provides a full set of documentation for the endpoints and a Try it out feature. Con questa funzionalità, è possibile immettere le impostazioni in un modulo HTML basato sul Web ed eseguire la query senza scrivere codice.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. Dopo che la query restituisce il risultato, viene fornito un comando CURL di esempio per illustrare il formato richiesto per il corpo e le intestazioni HTTP.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

Home page del contenitore

Arrestare il contenitoreStop the container

Per arrestare il contenitore, nell'ambiente della riga di comando in cui è in esecuzione il contenitore, premere CTRL + C.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.

Risoluzione dei problemiTroubleshooting

All'avvio o all'esecuzione del contenitore possono verificarsi problemi.When starting or running the container, you may experience issues. Usare un montaggio di output e abilitare la registrazione.Use an output mount and enable logging. Questa operazione consentirà al contenitore di generare file di log utili per la risoluzione dei problemi.Doing so will allow the container to generate log files that are helpful when troubleshooting issues.

Suggerimento

Per ulteriori informazioni e indicazioni sulla risoluzione dei problemi, vedere la pagina relativa alle domande frequenti sui contenitori di servizi cognitivi.For more troubleshooting information and guidance, see Cognitive Services containers frequently asked questions (FAQ).

FatturazioneBilling

I contenitori di riconoscimento vocale inviano informazioni di fatturazione ad Azure, usando una risorsa vocale nell'account Azure.The Speech containers send billing information to Azure, using a Speech resource on your Azure account.

Le query sul contenitore vengono fatturate secondo il piano tariffario della risorsa di Azure usata per <ApiKey>.Queries to the container are billed at the pricing tier of the Azure resource that's used for the <ApiKey>.

I contenitori di Servizi cognitivi di Azure non vengono concessi in licenza per l'esecuzione senza connessione all'endpoint di fatturazione per la misurazione.Azure Cognitive Services containers aren't licensed to run without being connected to the billing endpoint for metering. È necessario consentire ai contenitori di comunicare sempre le informazioni di fatturazione all'endpoint di fatturazione.You must enable the containers to communicate billing information with the billing endpoint at all times. I contenitori di Servizi cognitivi non inviano a Microsoft i dati dei clienti, ad esempio l'immagine o il testo analizzato.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

Connettersi ad AzureConnect to Azure

Per eseguire il contenitore, sono necessari i valori dell'argomento di fatturazione.The container needs the billing argument values to run. Questi valori consentono al contenitore di connettersi all'endpoint di fatturazione.These values allow the container to connect to the billing endpoint. Il contenitore segnala l'utilizzo ogni 10-15 minuti.The container reports usage about every 10 to 15 minutes. Se il contenitore non si connette ad Azure entro la finestra temporale consentita, continuerà a essere eseguito ma non fornirà query finché l'endpoint di fatturazione non verrà ripristinato.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. Il tentativo di connessione viene effettuato 10 volte nello stesso intervallo di tempo di 10-15 minuti.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Se non è possibile stabilire la connessione con l'endpoint di fatturazione entro i 10 tentativi, l'esecuzione del contenitore verrà arrestata.If it can't connect to the billing endpoint within the 10 tries, the container stops running.

Argomenti di fatturazioneBilling arguments

Per avviare il contenitore con il comando docker run, è necessario che vengano specificate tutte e tre le opzioni seguenti con valori validi:For the docker run command to start the container, all three of the following options must be specified with valid values:

OpzioneOption DescriptionDescription
ApiKey Chiave API della risorsa di Servizi cognitivi usata per tenere traccia delle informazioni di fatturazione.The API key of the Cognitive Services resource that's used to track billing information.
Il valore di questa opzione deve essere impostato su una chiave API per la risorsa di cui è stato effettuato il provisioning specificata in Billing.The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
Billing Endpoint della risorsa di Servizi cognitivi usata per tenere traccia delle informazioni di fatturazione.The endpoint of the Cognitive Services resource that's used to track billing information.
Il valore di questa opzione deve essere impostato sull'URI dell'endpoint di una risorsa di Azure di cui è stato effettuato il provisioning.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
Eula Indica che è la licenza per il contenitore è stata accettata.Indicates that you accepted the license for the container.
Il valore di questa opzione deve essere impostato su accept.The value of this option must be set to accept.

Per altre informazioni su queste opzioni, vedere Configurare i contenitori.For more information about these options, see Configure containers.

Post di blogBlog posts

Esempi per gli sviluppatoriDeveloper samples

Gli esempi per gli sviluppatori sono disponibili nel repository GitHub.Developer samples are available at our GitHub repository.

Visualizza il webinarView webinar

Partecipare al webinar per saperne di più sugli argomenti seguenti:Join the webinar to learn about:

  • Come distribuire Servizi cognitivi in qualsiasi computer con DockerHow to deploy Cognitive Services to any machine using Docker
  • Come distribuire Servizi cognitivi nel servizio Azure ContainerHow to deploy Cognitive Services to AKS

RiepilogoSummary

In questo articolo sono stati appresi concetti e flussi di lavoro per il download, l'installazione e l'esecuzione di contenitori di sintesi vocale.In this article, you learned concepts and workflow for downloading, installing, and running Speech containers. In sintesi:In summary:

  • Il riconoscimento vocale fornisce quattro contenitori Linux per Docker, incapsulando varie funzionalità:Speech provides four Linux containers for Docker, encapsulating various capabilities:
    • Riconoscimento vocaleSpeech-to-text
    • Da Riconoscimento vocale personalizzato a testoCustom Speech-to-text
    • Sintesi vocaleText-to-speech
    • Sintesi vocale personalizzataCustom Text-to-speech
  • Le immagini del contenitore vengono scaricate dal registro contenitori in Azure.Container images are downloaded from the container registry in Azure.
  • Le immagini dei contenitori vengono eseguite in Docker.Container images run in Docker.
  • È possibile usare l'API REST o l'SDK per chiamare le operazioni nei contenitori di sintesi vocale specificando l'URI host del contenitore.You can use either the REST API or SDK to call operations in Speech containers by specifying the host URI of the container.
  • È necessario fornire informazioni di fatturazione quando si crea un'istanza di un contenitore.You're required to provide billing information when instantiating a container.

Importante

I contenitori di Servizi cognitivi non sono concessi in licenza per l'esecuzione senza essere connessi ad Azure per la misurazione.Cognitive Services containers are not licensed to run without being connected to Azure for metering. I clienti devono consentire ai contenitori di comunicare sempre le informazioni di fatturazione al servizio di misurazione.Customers need to enable the containers to communicate billing information with the metering service at all times. I contenitori di Servizi cognitivi non inviano i dati dei clienti (ad esempio, l'immagine o il testo analizzato) a Microsoft.Cognitive Services containers do not send customer data (e.g., the image or text that is being analyzed) to Microsoft.

Passaggi successiviNext steps