Tal till text-containrar med Docker

Containern Tal till text transkriberar tal- eller batchljudinspelningar i realtid med mellanliggande resultat. I den här artikeln får du lära dig hur du laddar ned, installerar och kör en tal till text-container.

Mer information om förutsättningar, verifiering av att en container körs, körning av flera containrar på samma värd och körning av frånkopplade containrar finns i Installera och köra Speech-containrar med Docker.

Containeravbildningar

Containeravbildningen Tal till text för alla versioner och nationella inställningar som stöds finns i MCR-syndikatet (Microsoft Container Registry). Den finns på lagringsplatsen azure-cognitive-services/speechservices/ och heter speech-to-text.

Det fullständigt kvalificerade containeravbildningsnamnet är , mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text. Lägg antingen till en viss version eller lägg till :latest för att hämta den senaste versionen.

Version	Sökväg
Senast	mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:latest Taggen latest hämtar den senaste avbildningen en-US för nationella inställningar.
4.6.0	mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:4.6.0-amd64-mr-in

Alla taggar, förutom latest, är i följande format och är skiftlägeskänsliga:

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

Taggarna är också tillgängliga i JSON-format för din bekvämlighet. Brödtexten innehåller containersökvägen och listan med taggar. Taggarna sorteras inte efter version, men "latest" ingår alltid i slutet av listan enligt följande kodfragment:

{
  "name": "azure-cognitive-services/speechservices/speech-to-text",
  "tags": [
    "2.10.0-amd64-ar-ae",
    "2.10.0-amd64-ar-bh",
    "2.10.0-amd64-ar-eg",
    "2.10.0-amd64-ar-iq",
    "2.10.0-amd64-ar-jo",
    <--redacted for brevity-->
    "latest"
  ]
}

Hämta containeravbildningen med docker pull

Du behöver kraven, inklusive nödvändig maskinvara. Se även den rekommenderade allokeringen av resurser för varje Speech-container.

Använd docker pull-kommandot för att ladda ned en containeravbildning från Microsoft Container Registry:

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

Viktigt!

Taggen latest hämtar den senaste avbildningen en-US för nationella inställningar. Ytterligare versioner och nationella inställningar finns i tal till textcontaineravbildningar.

Kör containern med docker-körning

Använd kommandot docker run för att köra containern.

Tal till text

Följande tabell representerar de olika docker run parametrarna och deras motsvarande beskrivningar:

Parameter	Description
{ENDPOINT_URI}	Slutpunkten krävs för mätning och fakturering. Mer information finns i faktureringsargument.
{API_KEY}	API-nyckeln krävs. Mer information finns i faktureringsargument.

När du kör tal till text-containern konfigurerar du porten, minnet och PROCESSORn enligt kraven och rekommendationerna för tal-till-text-containern.

Här är ett exempelkommando docker run med platshållarvärden. Du måste ange ENDPOINT_URI värdena och API_KEY :

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

Det här kommandot:

• Kör en speech-to-text container från containeravbildningen.
• Allokerar 4 CPU-kärnor och 8 GB minne.
• Exponerar TCP-port 5000 och allokerar en pseudo-TTY för containern.
• Tar automatiskt bort containern när den har avslutats. Containeravbildningen är fortfarande tillgänglig på värddatorn.

Frånkopplat tal till text

Om du vill köra frånkopplade containrar (inte anslutna till Internet) måste du skicka det här begärandeformuläret och vänta på godkännande. Mer information om hur du tillämpar och köper en åtagandeplan för att använda containrar i frånkopplade miljöer finns i Använda containrar i frånkopplade miljöer i Dokumentationen om Azure AI-tjänster.

Om du är godkänd för att köra containern frånkopplad från Internet visar följande exempel formateringen av kommandot som docker run ska användas, med platshållarvärden. Ersätt dessa platshållarvärden med dina egna värden.

Parametern DownloadLicense=True i kommandot docker run laddar ned en licensfil så att Docker-containern kan köras när den inte är ansluten till Internet. Den innehåller också ett förfallodatum, varefter licensfilen är ogiltig för att köra containern. Du kan bara använda en licensfil med lämplig container som du är godkänd för. Du kan till exempel inte använda en licensfil för en speech-to-text container med en neural-text-to-speech container.

Platshållare	beskrivning
{IMAGE}	Den containeravbildning som du vill använda. Till exempel: mcr.microsoft.com/azure-cognitive-services/speech-to-text:latest
{LICENSE_MOUNT}	Sökvägen där licensen laddas ned och monteras. Till exempel: /host/license:/path/to/license/directory
{ENDPOINT_URI}	Slutpunkten för att autentisera din tjänstbegäran. Du hittar den på resursens nyckel- och slutpunktssida i Azure-portalen. Till exempel: https://<your-resource-name>.cognitiveservices.azure.com
{API_KEY}	Nyckeln för din Speech-resurs. Du hittar den på resursens nyckel- och slutpunktssida i Azure-portalen.
{CONTAINER_LICENSE_DIRECTORY}	Plats för licensmappen i containerns lokala filsystem. Till exempel: /path/to/license/directory

docker run --rm -it -p 5000:5000 \ 
-v {LICENSE_MOUNT} \
{IMAGE} \
eula=accept \
billing={ENDPOINT_URI} \
apikey={API_KEY} \
DownloadLicense=True \
Mounts:License={CONTAINER_LICENSE_DIRECTORY} 

När licensfilen har laddats ned kan du köra containern i en frånkopplad miljö. I följande exempel visas formateringen för det docker run kommando som du använder, med platshållarvärden. Ersätt dessa platshållarvärden med dina egna värden.

Oavsett var containern körs måste licensfilen monteras på containern och platsen för licensmappen i containerns lokala filsystem måste anges med Mounts:License=. En utdatamontering måste också anges så att faktureringsanvändningsposter kan skrivas.

Platshållare	Värde	Format eller exempel
{IMAGE}	Den containeravbildning som du vill använda. Till exempel: mcr.microsoft.com/azure-cognitive-services/speech-to-text:latest
{MEMORY_SIZE}	Lämplig storlek på minne som ska allokeras för containern. Till exempel: 4g
{NUMBER_CPUS}	Lämpligt antal processorer som ska allokeras för din container. Till exempel: 4
{LICENSE_MOUNT}	Sökvägen där licensen finns och monteras. Till exempel: /host/license:/path/to/license/directory
{OUTPUT_PATH}	Utdatasökvägen för loggning. Till exempel: /host/output:/path/to/output/directory Mer information finns i användningsposter i dokumentationen för Azure AI-tjänster.
{CONTAINER_LICENSE_DIRECTORY}	Plats för licensmappen i containerns lokala filsystem. Till exempel: /path/to/license/directory
{CONTAINER_OUTPUT_DIRECTORY}	Plats för utdatamappen i containerns lokala filsystem. Till exempel: /path/to/output/directory

docker run --rm -it -p 5000:5000 --memory {MEMORY_SIZE} --cpus {NUMBER_CPUS} \ 
-v {LICENSE_MOUNT} \ 
-v {OUTPUT_PATH} \
{IMAGE} \
eula=accept \
Mounts:License={CONTAINER_LICENSE_DIRECTORY}
Mounts:Output={CONTAINER_OUTPUT_DIRECTORY}

Talcontainrar tillhandahåller en standardkatalog för att skriva licensfilen och faktureringsloggen vid körning. Standardkatalogerna är /license respektive /output.

När du monterar dessa kataloger i containern med docker run -v kommandot kontrollerar du att den lokala datorkatalogen är inställd på user:group nonroot:nonroot ägarskap innan du kör containern.

Här är ett exempelkommando för att ange fil-/katalogägarskap.

sudo chown -R nonroot:nonroot <YOUR_LOCAL_MACHINE_PATH_1> <YOUR_LOCAL_MACHINE_PATH_2> ...

Mer information om docker run med Speech-containrar finns i Installera och köra Speech-containrar med Docker.

Använda containern

Talcontainrar tillhandahåller websocketbaserade frågeslutpunkts-API:er som nås via Speech SDK och Speech CLI. Som standard använder Speech SDK och Speech CLI den offentliga Speech-tjänsten. Om du vill använda containern måste du ändra initieringsmetoden.

Viktigt!

När du använder Speech-tjänsten med containrar måste du använda värdautentisering. Om du konfigurerar nyckeln och regionen går begäranden till den offentliga Speech-tjänsten. Resultat från Speech-tjänsten kanske inte är vad du förväntar dig. Begäranden från frånkopplade containrar misslyckas.

I stället för att använda den här initieringskonfigurationen för Azure-molnet:

var config = SpeechConfig.FromSubscription(...);

Använd den här konfigurationen med containervärden:

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

I stället för att använda den här initieringskonfigurationen för Azure-molnet:

auto speechConfig = SpeechConfig::FromSubscription(...);

Använd den här konfigurationen med containervärden:

auto speechConfig = SpeechConfig::FromHost("ws://localhost:5000");

I stället för att använda den här initieringskonfigurationen för Azure-molnet:

speechConfig, err := speech.NewSpeechConfigFromSubscription(...)

Använd den här konfigurationen med containervärden:

speechConfig, err := speech.NewSpeechConfigFromHost("ws://localhost:5000")

I stället för att använda den här initieringskonfigurationen för Azure-molnet:

SpeechConfig speechConfig = SpeechConfig.fromSubscription(...);

Använd den här konfigurationen med containervärden:

SpeechConfig speechConfig = SpeechConfig.fromHost("ws://localhost:5000");

I stället för att använda den här initieringskonfigurationen för Azure-molnet:

const speechConfig = sdk.SpeechConfig.fromSubscription(...);

Använd den här konfigurationen med containervärden:

const speechConfig = sdk.SpeechConfig.fromHost("ws://localhost:5000");

I stället för att använda den här initieringskonfigurationen för Azure-molnet:

SPXSpeechConfiguration *speechConfig = [[SPXSpeechConfiguration alloc] initWithSubscription:...];

Använd den här konfigurationen med containervärden:

SPXSpeechConfiguration *speechConfig = [[SPXSpeechConfiguration alloc] initWithHost:"ws://localhost:5000"];

I stället för att använda den här initieringskonfigurationen för Azure-molnet:

let speechConfig = SPXSpeechConfiguration(subscription: "", region: "");

Använd den här konfigurationen med containervärden:

let speechConfig = SPXSpeechConfiguration(host: "ws://localhost:5000");

I stället för att använda den här initieringskonfigurationen för Azure-molnet:

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

Använd den här konfigurationen med containerslutpunkten:

speech_config = speechsdk.SpeechConfig(
    host="ws://localhost:5000")

När du använder Speech CLI i en container inkluderar du alternativet --host ws://localhost:5000/ . Du måste också ange --key none för att säkerställa att CLI inte försöker använda en Talnyckel för autentisering. Information om hur du konfigurerar Speech CLI finns i Komma igång med Azure AI Speech CLI.

Prova snabbstarten tal till text med värdautentisering i stället för nyckel och region.

Nästa steg

• Se översikten över Speech-containrar
• Granska konfigurera containrar för konfigurationsinställningar
• Använda fler Azure AI-containrar