Instalar e executar contêineres do serviço de fala (versão prévia)Install and run Speech service containers (Preview)

Os contêineres permitem executar algumas das APIs do serviço de fala em seu próprio ambiente.Containers enable you to run some of the Speech service APIs in your own environment. Os contêineres são ótimos para requisitos específicos de segurança e governança de dados.Containers are great for specific security and data governance requirements. Neste artigo, você aprenderá a baixar, instalar e executar um contêiner de fala.In this article you'll learn how to download, install, and run a Speech container.

Os contêineres de fala permitem que os clientes criem uma arquitetura de aplicativo de fala otimizada para recursos de nuvem robustos e localidade de borda.Speech containers enable customers to build a speech application architecture that is optimized for both robust cloud capabilities and edge locality. Há quatro contêineres diferentes disponíveis.There are four different containers available. Os dois contêineres padrão são Text -to-Text e conversão de texto em fala.The two standard containers are Speech-to-text and Text-to-speech. Os dois contêineres personalizados são fala personalizada para texto e texto em fala personalizado.The two custom containers are Custom Speech-to-text and Custom Text-to-speech.

Importante

Atualmente, todos os contêineres de fala são oferecidos como parte de uma Visualização pública "restrita".All speech containers are currently offered as part of a Public "Gated" Preview. Um comunicado será feito quando os contêineres de fala progredirem para disponibilidade geral (GA).An announcement will be made when speech containers progress to General Availability (GA).

FunçãoFunction FuncionalidadesFeatures Mais recenteLatest
Conversão de voz em textoSpeech-to-text Transcreve as gravações contínuas de fala em tempo real ou de áudio em lotes em texto com resultados intermediários.Transcribes continuous real-time speech or batch audio recordings into text with intermediate results. 2.0.02.0.0
Fala Personalizada para textoCustom Speech-to-text Usar um modelo personalizado do portal de fala personalizada, transcreve gravações contínuas em tempo real ou de áudio em lotes em texto com resultados intermediários.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
Conversão de texto em vozText-to-speech Converte texto em fala natural-som com entrada de texto sem formatação ou SSML (linguagem de marcação de síntese de fala).Converts text to natural-sounding speech with plain text input or Speech Synthesis Markup Language (SSML). 1.3.01.3.0
Conversão de texto em fala personalizadaCustom Text-to-speech Usando um modelo personalizado do portal de voz personalizado, o converte o texto em fala de som natural com entrada de texto sem formatação ou SSML (linguagem de marcação de síntese de fala).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 não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Pré-requisitosPrerequisites

Os seguintes pré-requisitos antes de usar os contêineres de fala:The following prerequisites before using Speech containers:

ObrigatórioRequired FinalidadePurpose
Motor do DockerDocker Engine Você precisa do mecanismo do Docker instalado em um computador host.You need the Docker Engine installed on a host computer. O Docker fornece pacotes que configuram o ambiente do Docker no MacOS, no Windowse no Linux.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. Para obter um manual sobre noções básicas do Docker e um contentor, consulte a descrição geral do Docker.For a primer on Docker and container basics, see the Docker overview.

Docker tem de ser configurado para permitir que os contentores para se ligar com e enviar dados de faturação para o Azure.Docker must be configured to allow the containers to connect with and send billing data to Azure.

No Windows, o Docker também deve ser configurado para dar suporte a contêineres do Linux.On Windows, Docker must also be configured to support Linux containers.

Familiaridade com o DockerFamiliarity with Docker Você deve ter uma compreensão básica dos conceitos do Docker, como registros, repositórios, contêineres e imagens de contêiner, bem como o conhecimento de comandos básicos de docker.You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.
Recurso de falaSpeech resource Para usar esses contêineres, você deve ter:In order to use these containers, you must have:

Um recurso de fala do Azure para obter a chave de API e o URI de ponto de extremidade associados.An Azure Speech resource to get the associated API key and endpoint URI. Ambos os valores estão disponíveis nas páginas visão geral de fala e chaves de portal do Azure.Both values are available on the Azure portal's Speech Overview and Keys pages. Eles são necessários para iniciar o contêiner.They are both required to start the container.

{Api_key} : uma das duas chaves de recurso disponíveis na página chaves{API_KEY}: One of the two available resource keys on the Keys page

{ENDPOINT_URI} : o ponto de extremidade conforme fornecido na página visão geral{ENDPOINT_URI}: The endpoint as provided on the Overview page

Solicitar acesso ao registro de contêinerRequest access to the container registry

Preencha e envie o formulário de solicitação de contêineres de fala dos serviços cognitivas para solicitar acesso ao contêiner.Fill out and submit the Cognitive Services Speech Containers Request form to request access to the container.

O formulário solicita as informações sobre si, sua empresa e o cenário de utilizador que vai utilizar o contentor.The form requests information about you, your company, and the user scenario for which you'll use the container. Depois de enviar o formulário, a equipe de serviços cognitivas do Azure revisa-o para garantir que você atenda aos critérios de acesso ao registro de contêiner privado.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

Você deve usar um endereço de email associado a uma conta da Microsoft (MSA) ou Azure Active Directory (Azure AD) no formulário.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 sua solicitação for aprovada, você receberá um email com instruções que descrevem como obter suas credenciais e acessar o registro de contêiner privado.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.

Usar a CLI do Docker para autenticar o registro de contêiner privadoUse the Docker CLI to authenticate the private container registry

Você pode autenticar com o registro de contêiner privado para contêineres de serviços cognitivas de várias maneiras, mas o método recomendado na linha de comando é usar a CLI do 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.

Use o comandodocker login, conforme mostrado no exemplo a seguir, para fazer logon em containerpreview.azurecr.io, o registro de contêiner privado para contêineres de serviços cognitivas.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. Substitua <username> pelo nome de usuário e <senha> pela senha fornecida nas credenciais que você recebeu da equipe de serviços cognitivas do 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 você protegeu suas credenciais em um arquivo de texto, você pode concatenar o conteúdo desse arquivo de texto, usando o comando cat, para o comando docker login, conforme mostrado no exemplo a seguir.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. Substitua <passwordfile> pelo caminho e nome do arquivo de texto que contém a senha e <nome de usuário>com o nome que é fornecido em suas credenciais.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

Coletando parâmetros necessáriosGathering required parameters

Há três parâmetros principais para todos os contêineres de serviços cognitivas que são necessários.There are three primary parameters for all Cognitive Services' containers that are required. O contrato de licença de usuário final (EULA) deve estar presente com um valor de accept.The end-user license agreement (EULA) must be present with a value of accept. Além disso, uma URL de ponto de extremidade e uma chave de API são necessárias.Additionally, both an Endpoint URL and API Key are needed.

URI do ponto de extremidade {ENDPOINT_URI}Endpoint URI {ENDPOINT_URI}

O valor do URI do ponto de extremidade está disponível na página de visão geral portal do Azure do recurso de serviço cognitiva correspondente.The Endpoint URI value is available on the Azure portal Overview page of the corresponding Cognitive Service resource. Navegue até a página visão geral , passe o mouse sobre o ponto de extremidade e um ícone de Copy to clipboard aparecerá.Navigate to the Overview page, hover over the Endpoint, and a Copy to clipboard icon will appear. Copie e use onde for necessário.Copy and use where needed.

Coletar o URI do ponto de extremidade para uso posterior

Chaves {API_KEY}Keys {API_KEY}

Essa chave é usada para iniciar o contêiner e está disponível na página chaves do portal do Azure do recurso de serviço cognitiva correspondente.This key is used to start the container, and is available on the Azure portal's Keys page of the corresponding Cognitive Service resource. Navegue até a página chaves e clique no ícone de Copy to clipboard .Navigate to the Keys page, and click on the Copy to clipboard icon.

Obter uma das duas chaves para uso posterior

Importante

Essas chaves de assinatura são usadas para acessar sua API de serviço cognitiva.These subscription keys are used to access your Cognitive Service API. Não compartilhe suas chaves.Do not share your keys. Armazene-os com segurança, por exemplo, usando Azure Key Vault.Store them securely, for example, using Azure Key Vault. Também recomendamos regenerar essas chaves regularmente.We also recommend regenerating these keys regularly. Apenas uma chave é necessária para fazer uma chamada à API.Only one key is necessary to make an API call. Ao regenerar a primeira chave, você pode usar a segunda chave para obter acesso contínuo ao serviço.When regenerating the first key, you can use the second key for continued access to the service.

O computador hostThe host computer

O host é um computador baseado em x64 que executa o contêiner do Docker.The host is a x64-based computer that runs the Docker container. Ele pode ser um computador em seu local ou em um serviço de hospedagem do Docker no Azure, como:It can be a computer on your premises or a Docker hosting service in Azure, such as:

Suporte à extensão de vetor avançadoAdvanced Vector Extension support

O host é o computador que executa o contêiner do Docker.The host is the computer that runs the docker container. O host deve dar suporte a extensões de vetor avançadas (AVX2).The host must support Advanced Vector Extensions (AVX2). Você pode verificar o suporte a AVX2 em hosts Linux com o seguinte comando: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

Aviso

O computador host é necessário para dar suporte a AVX2.The host computer is required to support AVX2. O contêiner não funcionará corretamente sem o suporte do AVX2.The container will not function correctly without AVX2 support.

Requisitos do contentor e recomendaçõesContainer requirements and recommendations

A tabela a seguir descreve a alocação mínima e recomendada de recursos para cada contêiner de fala.The following table describes the minimum and recommended allocation of resources for each Speech container.

ContentorContainer MínimoMinimum RecomendadoRecommended
Conversão de voz em textoSpeech-to-text 2 núcleos, 2 GB de memória2 core, 2-GB memory 4 núcleos, 4 GB de memória4 core, 4-GB memory
  • Cada núcleo deve ter pelo menos 2,6 gigahertz (GHz) ou mais rápido.Each core must be at least 2.6 gigahertz (GHz) or faster.

O núcleo e a memória correspondem às configurações de --cpus e --memory, que são usadas como parte do comando docker run.Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

Nota

O mínimo e recomendado são baseados nos limites do Docker, não nos recursos da máquina host.The minimum and recommended are based off of Docker limits, not the host machine resources. Por exemplo, os contêineres de conversão de texto na memória mapeiam partes de um modelo de linguagem grande e é recomendável que todo o arquivo caiba na memória, que é de 4-6 GB adicionais.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. Além disso, a primeira execução de qualquer um dos contêineres pode levar mais tempo, pois os modelos estão sendo paginados na memória.Also, the first run of either container may take longer, since models are being paged into memory.

Obter a imagem de contêiner com docker pullGet the container image with docker pull

As imagens de contêiner para fala estão disponíveis no registro de contêiner a seguir.Container images for Speech are available in the following Container Registry.

ContentorContainer RepositórioRepository
Conversão de voz em textoSpeech-to-text containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text:latest

Dica

Pode utilizar o imagens do docker command para listar as imagens de contentor transferido.You can use the docker images command to list your downloaded container images. Por exemplo, o comando seguinte lista o ID, o repositório e a etiqueta de cada imagem de contentor transferido, formatada como uma tabela: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 do Docker para os contêineres de falaDocker pull for the Speech containers

Pull do Docker para o contêiner de conversão de fala em textoDocker pull for the Speech-to-text container

Use o comando Docker pull para baixar uma imagem de contêiner do registro de visualização de contêiner.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

A marca de latest extrai a localidade en-US.The latest tag pulls the en-US locale. Para localidades adicionais, consulte localidades de fala para texto.For additional locales see Speech-to-text locales.

Localidades de conversão de fala em textoSpeech-to-text locales

Todas as marcas, com exceção de latest estão no seguinte formato e diferenciam maiúsculas de minúsculas:All tags, except for latest are in the following format and are case-sensitive:

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

A marca a seguir é um exemplo do formato:The following tag is an example of the format:

2.0.0-amd64-en-us-preview

Para todas as localidades com suporte do contêiner de fala a texto , consulte marcas de imagem de fala para texto.For all of the supported locales of the speech-to-text container, please see Speech-to-text image tags.

Como usar o contêinerHow to use the container

Depois que o contêiner estiver no computador host, use o processo a seguir para trabalhar com o contêiner.Once the container is on the host computer, use the following process to work with the container.

  1. Execute o contêinercom as configurações de cobrança necessárias.Run the container, with the required billing settings. Mais exemplos do comando docker run estão disponíveis.More examples of the docker run command are available.
  2. Consulte o ponto de extremidade de previsão do contêiner.Query the container's prediction endpoint.

Execute o contêiner com docker runRun the container with docker run

Use o comando Docker execute para executar o contêiner.Use the docker run command to run the container. Consulte coletando parâmetros necessários para obter detalhes sobre como obter os valores de {Endpoint_URI} e de {API_Key}.Refer to gathering required parameters for details on how to get the {Endpoint_URI} and {API_Key} values. Exemplos adicionais do comando docker run também estão disponíveis.Additional examples of the docker run command are also available.

Para executar o contêiner de conversão de fala em texto , execute o comando docker run a seguir.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}

Este comando:This command:

  • Executa um contêiner de conversão de fala em texto da imagem de contêiner.Runs a Speech-to-text container from the container image.
  • Aloca 4 núcleos de CPU e 4 gigabytes (GB) de memória.Allocates 4 CPU cores and 4 gigabytes (GB) of memory.
  • Expõe a porta TCP 5000 e aloca um pseudo-TTY para o contêiner.Exposes TCP port 5000 and allocates a pseudo-TTY for the container.
  • Remove automaticamente o contêiner depois que ele é encerrado.Automatically removes the container after it exits. A imagem de contêiner ainda está disponível no computador host.The container image is still available on the host computer.

Importante

O Eula, Billing, e ApiKey opções tem de ser especificadas para executar o contentor; caso contrário, não inicia o contentor.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Para obter mais informações, consulte faturação.For more information, see Billing.

Consultar o ponto de extremidade de previsão do contêinerQuery the container's prediction endpoint

ContentoresContainers URL do host do SDKSDK Host URL ProtocoloProtocol
Conversão de fala em texto e Fala Personalizada em textoSpeech-to-text and Custom Speech-to-text ws://localhost:5000 WSWS
Conversão de texto em fala e Text-to-Speech personalizadoText-to-speech and Custom Text-to-speech http://localhost:5000 HTTPHTTP

Para obter mais informações sobre como usar os protocolos do WSS e HTTPS, consulte segurança do contêiner.For more information on using WSS and HTTPS protocols, see container security.

Conversão de fala em texto ou Fala Personalizada em textoSpeech-to-text or Custom Speech-to-text

O contêiner fornece APIs de ponto de extremidade de consulta baseadas no WebSocket, que são acessadas por meio do SDK de fala.The container provides websocket-based query endpoint APIs, that are accessed through the Speech SDK. Por padrão, o SDK de fala usa os serviços de fala online.By default, the Speech SDK uses online speech services. Para usar o contêiner, você precisa alterar o método de inicialização.To use the container, you need to change the initialization method.

Dica

Ao usar o SDK de fala com contêineres, você não precisa fornecer a chave de assinatura de recurso de fala do Azure ou um token de portador de autenticação.When using the Speech SDK with containers, you do not need to provide the Azure Speech resource subscription key or an authentication bearer token.

Veja os exemplos abaixo.See the examples below.

Alterar do uso desta chamada de inicialização do Azure-cloud:Change from using this Azure-cloud initialization call:

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

para essa chamada usando o hostdo contêiner:to this call using the container host:

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

Conversão de texto em fala ou personalizada para falaText-to-speech or Custom Text-to-speech

O contêiner fornece APIs de ponto de extremidade baseadas em REST.The container provides REST-based endpoint APIs. Há muitos projetos de código-fonte de exemplo para a plataforma, estrutura e variações de linguagem disponíveis.There are many sample source code projects for platform, framework, and language variations available.

Com o contêiner de conversão de texto em fala padrão , você deve confiar na localidade e na voz da marca de imagem que baixou.With the Standard Text-to-speech container, you should rely on the locale and voice of the image tag you downloaded. Por exemplo, se você baixou a marca de latest, a localidade padrão será en-US e a voz JessaRUS.For example, if you downloaded the latest tag the default locale is en-US and the JessaRUS voice. O argumento {VOICE_NAME} seria então en-US-JessaRUS.The {VOICE_NAME} argument would then be en-US-JessaRUS. Consulte o exemplo SSML abaixo: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>

No entanto, para texto personalizado para fala , você precisará obter a voz/modelo do portal de voz personalizado.However, for Custom Text-to-speech you'll need to obtain the Voice / model from the custom voice portal. O nome do modelo personalizado é sinônimo do nome da voz.The custom model name is synonymous with the voice name. Navegue até a página de treinamento e copie a voz/modelo para usar como o argumento {VOICE_NAME}.Navigate to the Training page, and copy the Voice / model to use as the {VOICE_NAME} argument.

Modelo de voz personalizado-nome da voz

Consulte o exemplo SSML abaixo: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>

Vamos construir uma solicitação HTTP POST, fornecendo alguns cabeçalhos e uma carga de dados.Let's construct an HTTP POST request, providing a few headers and a data payload. Substitua o espaço reservado {VOICE_NAME} pelo seu próprio valor.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>'

Este comando:This command:

  • Constrói uma solicitação HTTP POST para o ponto de extremidade speech/synthesize/cognitiveservices/v1.Constructs an HTTP POST request for the speech/synthesize/cognitiveservices/v1 endpoint.
  • Especifica um cabeçalho de Accept de audio/*Specifies an Accept header of audio/*
  • Especifica um cabeçalho Content-Type de application/ssml+xml, para obter mais informações, consulte corpo da solicitação.Specifies a Content-Type header of application/ssml+xml, for more information, see request body.
  • Especifica um cabeçalho X-Microsoft-OutputFormat de riff-16khz-16bit-mono-pcm, para obter mais opções, consulte saída de áudio.Specifies a X-Microsoft-OutputFormat header of riff-16khz-16bit-mono-pcm, for more options see audio output.
  • Envia a solicitação de linguagem de marcação de síntese de fala (SSML) dada a {VOICE_NAME} ao ponto de extremidade.Sends the Speech Synthesis Markup Language (SSML) request given the {VOICE_NAME} to the endpoint.

Executar vários contêineres no mesmo hostRun multiple containers on the same host

Se você pretende executar vários contêineres com portas expostas, certifique-se de executar cada contêiner com uma porta exposta diferente.If you intend to run multiple containers with exposed ports, make sure to run each container with a different exposed port. Por exemplo, execute o primeiro contêiner na porta 5000 e o segundo contêiner na porta 5001.For example, run the first container on port 5000 and the second container on port 5001.

Você pode ter esse contêiner e um contêiner diferente de serviços cognitivas do Azure em execução no HOST juntos.You can have this container and a different Azure Cognitive Services container running on the HOST together. Você também pode ter vários contêineres do mesmo contêiner de serviços cognitivas em execução.You also can have multiple containers of the same Cognitive Services container running.

Validar que um contêiner está em execuçãoValidate that a container is running

Há várias maneiras de validar que o contêiner está em execução.There are several ways to validate that the container is running. Localize o endereço IP externo e a porta exposta do contêiner em questão e abra seu navegador da Web favorito.Locate the External IP address and exposed port of the container in question, and open your favorite web browser. Use as várias URLs de solicitação abaixo para validar se o contêiner está em execução.Use the various request URLs below to validate the container is running. As URLs de solicitação de exemplo listadas abaixo são http://localhost:5000, mas seu contêiner específico pode variar.The example request URLs listed below are http://localhost:5000, but your specific container may vary. Tenha em mente que você depende do endereço IP externo do seu contêiner e da porta exposta.Keep in mind that you're to rely on your container's External IP address and exposed port.

URL do PedidoRequest URL FinalidadePurpose
http://localhost:5000/ O contêiner fornece um home page.The container provides a home page.
http://localhost:5000/status Solicitado com um HTTP GET, para validar que o contêiner está em execução sem causar uma consulta de ponto de extremidade.Requested with an HTTP GET, to validate that the container is running without causing an endpoint query. Essa solicitação pode ser usada para investigações de prontidão e vidakubernetes.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/swagger O contêiner fornece um conjunto completo de documentação para os pontos de extremidade e um recurso Experimente .The container provides a full set of documentation for the endpoints and a Try it out feature. Com esse recurso, você pode inserir suas configurações em um formulário HTML baseado na Web e fazer a consulta sem precisar escrever nenhum código.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. Depois que a consulta retorna, um exemplo de comando de ONDULAção é fornecido para demonstrar os cabeçalhos HTTP e o formato de corpo necessários.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

home page do contêiner

Parar o contentorStop the container

Para desligar o contêiner, no ambiente de linha de comando em que o contêiner está em execução, selecione Ctrl + C.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.

Resolução de problemasTroubleshooting

Ao iniciar ou executar o contêiner, você poderá ter problemas.When starting or running the container, you may experience issues. Use uma montagem de saída e habilite o registro em log.Use an output mount and enable logging. Isso permitirá que o contêiner gere arquivos de log que são úteis ao solucionar problemas.Doing so will allow the container to generate log files that are helpful when troubleshooting issues.

Dica

Para obter mais informações e diretrizes de solução de problemas, consulte perguntas frequentes sobre os contêineres de serviços cognitivas.For more troubleshooting information and guidance, see Cognitive Services containers frequently asked questions (FAQ).

FaturaçãoBilling

Os contêineres de fala enviam informações de cobrança para o Azure, usando um recurso de fala em sua conta do Azure.The Speech containers send billing information to Azure, using a Speech resource on your Azure account.

As consultas ao contêiner são cobradas no tipo de preço do recurso do Azure que é usado para o <ApiKey>.Queries to the container are billed at the pricing tier of the Azure resource that's used for the <ApiKey>.

Os contêineres de serviços cognitivas do Azure não são licenciados para serem executados sem serem conectados ao ponto de extremidade de cobrança para medição.Azure Cognitive Services containers aren't licensed to run without being connected to the billing endpoint for metering. Você deve habilitar os contêineres para comunicar informações de cobrança com o ponto de extremidade de cobrança em todos os momentos.You must enable the containers to communicate billing information with the billing endpoint at all times. Os contêineres de serviços cognitivas não enviam dados do cliente, como a imagem ou o texto que está sendo analisado para a Microsoft.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

Ligar ao AzureConnect to Azure

O contêiner precisa dos valores do argumento de cobrança para executar.The container needs the billing argument values to run. Esses valores permitem que o contêiner se conecte ao ponto de extremidade de cobrança.These values allow the container to connect to the billing endpoint. O contêiner relata o uso de cada 10 a 15 minutos.The container reports usage about every 10 to 15 minutes. Se o contêiner não se conectar ao Azure dentro da janela de tempo permitida, o contêiner continuará a ser executado, mas não atenderá a consultas até que o ponto de extremidade de cobrança seja restaurado.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. A conexão é tentada 10 vezes ao mesmo tempo de 10 a 15 minutos.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Se ele não puder se conectar ao ponto de extremidade de cobrança dentro de 10 tentativas, o contêiner parará de ser executado.If it can't connect to the billing endpoint within the 10 tries, the container stops running.

Argumentos de cobrançaBilling arguments

Para o comando docker run para iniciar o contêiner, todas as três opções a seguir devem ser especificadas com valores válidos:For the docker run command to start the container, all three of the following options must be specified with valid values:

OpçãoOption DescriçãoDescription
ApiKey A chave de API do recurso de serviços cognitivas que é usado para rastrear informações de cobrança.The API key of the Cognitive Services resource that's used to track billing information.
O valor dessa opção deve ser definido como uma chave de API para o recurso provisionado que é especificado em Billing.The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
Billing O ponto de extremidade do recurso de serviços cognitivas que é usado para rastrear informações de cobrança.The endpoint of the Cognitive Services resource that's used to track billing information.
O valor dessa opção deve ser definido como o URI do ponto de extremidade de um recurso do Azure provisionado.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
Eula Indica que você aceitou a licença para o contêiner.Indicates that you accepted the license for the container.
O valor dessa opção deve ser definido como aceitar.The value of this option must be set to accept.

Para obter mais informações sobre estas opções, consulte configurar contentores.For more information about these options, see Configure containers.

Publicações no blogueBlog posts

Exemplos de programadorDeveloper samples

Exemplos de desenvolvedor estão disponíveis em nosso repositório GitHub.Developer samples are available at our GitHub repository.

Veja o webinarView webinar

Junte-se ao webinar para saber mais sobre:Join the webinar to learn about:

  • Como implantar serviços cognitivas em qualquer computador usando o DockerHow to deploy Cognitive Services to any machine using Docker
  • Como implantar serviços cognitivas no AKSHow to deploy Cognitive Services to AKS

ResumoSummary

Neste artigo, você aprendeu os conceitos e o fluxo de trabalho para baixar, instalar e executar contêineres de fala.In this article, you learned concepts and workflow for downloading, installing, and running Speech containers. Em resumo:In summary:

  • A fala fornece quatro contêineres do Linux para o Docker, encapsulando vários recursos:Speech provides four Linux containers for Docker, encapsulating various capabilities:
    • Conversão de voz em textoSpeech-to-text
    • Fala Personalizada para textoCustom Speech-to-text
    • Conversão de texto em vozText-to-speech
    • Conversão de texto em fala personalizadaCustom Text-to-speech
  • As imagens de contêiner são baixadas do registro de contêiner no Azure.Container images are downloaded from the container registry in Azure.
  • Executam imagens de contentor no Docker.Container images run in Docker.
  • Você pode usar a API REST ou o SDK para chamar operações em contêineres de fala especificando o URI do host do contêiner.You can use either the REST API or SDK to call operations in Speech containers by specifying the host URI of the container.
  • Você precisa fornecer informações de cobrança ao criar uma instância de um contêiner.You're required to provide billing information when instantiating a container.

Importante

Contentores de serviços cognitivos não estão licenciados para executar sem a ser ligado ao Azure para medição.Cognitive Services containers are not licensed to run without being connected to Azure for metering. Os clientes têm de ativar os contentores comunicar informações de faturação com o serviço de medição em todos os momentos.Customers need to enable the containers to communicate billing information with the metering service at all times. Contentores de serviços cognitivos não enviar dados de cliente (por exemplo, a imagem ou texto que está a ser analisado) para a Microsoft.Cognitive Services containers do not send customer data (e.g., the image or text that is being analyzed) to Microsoft.

Passos seguintesNext steps