Spraak-naar-tekstcontainers met Docker

De spraak-naar-tekstcontainer transcribeert realtime spraak- of batchaudio-opnamen met tussenliggende resultaten. In dit artikel leert u hoe u een spraak-naar-tekstcontainer downloadt, installeert en uitvoert.

Voor meer informatie over vereisten, valideren dat een container wordt uitgevoerd, meerdere containers op dezelfde host uitvoeren en niet-verbonden containers uitvoeren, raadpleegt u Speech-containers installeren en uitvoeren met Docker.

Containerinstallatiekopieën

De containerinstallatiekopie voor spraak-naar-tekst voor alle ondersteunde versies en landinstellingen vindt u in het MCR-syndicat (Microsoft Container Registry). Deze bevindt zich in de azure-cognitive-services/speechservices/ opslagplaats en heeft de naam speech-to-text.

De volledig gekwalificeerde containerinstallatiekopieënnaam is. mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text Voeg een specifieke versie toe of voeg toe :latest om de meest recente versie op te halen.

Versie	Pad
Laatste	mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:latest Met latest de tag wordt de meest recente installatiekopie voor de en-US landinstelling opgehaald.
4.6.0	mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:4.6.0-amd64-mr-in

Alle tags, met uitzondering van latest, hebben de volgende indeling en zijn hoofdlettergevoelig:

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

De tags zijn ook beschikbaar in JSON-indeling voor uw gemak. De hoofdtekst bevat het containerpad en de lijst met tags. De tags worden niet gesorteerd op versie, maar "latest" worden altijd opgenomen aan het einde van de lijst, zoals wordt weergegeven in dit fragment:

{
  "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"
  ]
}

De containerinstallatiekopie ophalen met docker pull

U hebt de vereisten nodig, inclusief vereiste hardware. Zie ook de aanbevolen toewijzing van resources voor elke Speech-container.

Gebruik de opdracht docker pull om een containerinstallatiekopie te downloaden uit Microsoft Container Registry:

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

Belangrijk

Met latest de tag wordt de meest recente installatiekopie voor de en-US landinstelling opgehaald. Zie spraak-naar-tekstcontainerinstallatiekopieën voor aanvullende versies en landinstellingen.

De container uitvoeren met docker-uitvoering

Gebruik de opdracht docker run om de container uit te voeren.

Spraak naar tekst

De volgende tabel vertegenwoordigt de verschillende docker run parameters en de bijbehorende beschrijvingen:

Parameter	Description
{ENDPOINT_URI}	Het eindpunt is vereist voor het meten en factureren. Zie factureringsargumenten voor meer informatie.
{API_KEY}	De API-sleutel is vereist. Zie factureringsargumenten voor meer informatie.

Wanneer u de spraak-naar-tekstcontainer uitvoert, configureert u de poort, het geheugen en de CPU op basis van de spraak-naar-tekstcontainervereisten en -aanbevelingen.

Hier volgt een voorbeeldopdracht docker run met tijdelijke aanduidingen. U moet de ENDPOINT_URI en API_KEY waarden opgeven:

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}

Met deze opdracht gebeurt het volgende:

• Voert een speech-to-text container uit vanuit de containerinstallatiekopieën.
• Wijst 4 CPU-kernen en 8 GB geheugen toe.
• Maakt TCP-poort 5000 beschikbaar en wijst een pseudo-TTY toe voor de container.
• Hiermee wordt de container automatisch verwijderd nadat deze is afgesloten. De containerinstallatiekopie is nog steeds beschikbaar op de hostcomputer.

Niet-verbonden spraak naar tekst

Als u niet-verbonden containers wilt uitvoeren (niet verbonden met internet), moet u dit aanvraagformulier indienen en wachten op goedkeuring. Zie Containers gebruiken in niet-verbonden omgevingen in de documentatie van Azure AI-services voor meer informatie over het toepassen en aanschaffen van een toezeggingsplan voor het gebruik van containers in niet-verbonden omgevingen .

Als u bent goedgekeurd om de container uit te voeren die is losgekoppeld van internet, ziet u in het volgende voorbeeld de opmaak van de docker run opdracht die moet worden gebruikt, met tijdelijke aanduidingen. Vervang deze tijdelijke aanduidingen door uw eigen waarden.

De DownloadLicense=True parameter in uw docker run opdracht downloadt een licentiebestand om uw Docker-container uit te voeren wanneer deze niet is verbonden met internet. Het bevat ook een vervaldatum, waarna het licentiebestand ongeldig is om de container uit te voeren. U kunt alleen een licentiebestand gebruiken met de juiste container waarvoor u bent goedgekeurd. U kunt bijvoorbeeld geen licentiebestand gebruiken voor een speech-to-text container met een neural-text-to-speech container.

Plaatsaanduiding	Beschrijving
{IMAGE}	De containerinstallatiekopieën die u wilt gebruiken. Bijvoorbeeld: mcr.microsoft.com/azure-cognitive-services/speech-to-text:latest
{LICENSE_MOUNT}	Het pad waar de licentie is gedownload en gekoppeld. Bijvoorbeeld: /host/license:/path/to/license/directory
{ENDPOINT_URI}	Het eindpunt voor het verifiëren van uw serviceaanvraag. U vindt deze op de pagina Sleutel en eindpunt van uw resource, in Azure Portal. Bijvoorbeeld: https://<your-resource-name>.cognitiveservices.azure.com
{API_KEY}	De sleutel voor uw Spraak-resource. U vindt deze op de pagina Sleutel en eindpunt van uw resource, in Azure Portal.
{CONTAINER_LICENSE_DIRECTORY}	Locatie van de licentiemap in het lokale bestandssysteem van de container. Bijvoorbeeld: /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} 

Zodra het licentiebestand is gedownload, kunt u de container uitvoeren in een niet-verbonden omgeving. In het volgende voorbeeld ziet u de opmaak van de opdracht die docker run u gebruikt, met tijdelijke aanduidingen. Vervang deze tijdelijke aanduidingen door uw eigen waarden.

Waar de container ook wordt uitgevoerd, moet het licentiebestand worden gekoppeld aan de container en moet de locatie van de licentiemap in het lokale bestandssysteem van de container worden opgegeven met Mounts:License=. Er moet ook een uitvoerkoppeling worden opgegeven, zodat factureringsgebruiksrecords kunnen worden geschreven.

Tijdelijke aanduiding	Weergegeven als	Opmaak of voorbeeld
{IMAGE}	De containerinstallatiekopieën die u wilt gebruiken. Bijvoorbeeld: mcr.microsoft.com/azure-cognitive-services/speech-to-text:latest
{MEMORY_SIZE}	De juiste grootte van het geheugen dat moet worden toegewezen voor uw container. Bijvoorbeeld: 4g
{NUMBER_CPUS}	Het juiste aantal CPU's dat moet worden toegewezen voor uw container. Bijvoorbeeld: 4
{LICENSE_MOUNT}	Het pad waar de licentie zich bevindt en is gekoppeld. Bijvoorbeeld: /host/license:/path/to/license/directory
{OUTPUT_PATH}	Het uitvoerpad voor logboekregistratie. Bijvoorbeeld: /host/output:/path/to/output/directory Zie de documentatie voor Azure AI-services voor meer informatie.
{CONTAINER_LICENSE_DIRECTORY}	Locatie van de licentiemap in het lokale bestandssysteem van de container. Bijvoorbeeld: /path/to/license/directory
{CONTAINER_OUTPUT_DIRECTORY}	Locatie van de uitvoermap in het lokale bestandssysteem van de container. Bijvoorbeeld: /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}

Spraakcontainers bieden een standaardmap voor het schrijven van het licentiebestand en het factureringslogboek tijdens runtime. De standaardmappen zijn respectievelijk /license en /output.

Wanneer u deze mappen aan de container wilt koppelen met de docker run -v opdracht, moet u ervoor zorgen dat de map van de lokale computer het eigendom user:group nonroot:nonroot heeft ingesteld voordat u de container uitvoert.

Hier volgt een voorbeeldopdracht voor het instellen van eigendom van bestanden/mappen.

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

Zie Speech-containers installeren en uitvoeren met Docker voor meer informatie over docker run spraakcontainers.

De container gebruiken

Spraakcontainers bieden websocket-api's voor query-eindpunten die toegankelijk zijn via de Speech SDK en Speech CLI. De Speech SDK en Speech CLI maken standaard gebruik van de openbare Speech-service. Als u de container wilt gebruiken, moet u de initialisatiemethode wijzigen.

Belangrijk

Wanneer u de Speech-service met containers gebruikt, moet u hostverificatie gebruiken. Als u de sleutel en regio configureert, worden aanvragen naar de openbare Spraak-service verzonden. Resultaten van de Speech-service zijn mogelijk niet wat u verwacht. Aanvragen van niet-verbonden containers mislukken.

In plaats van deze azure-cloud-initialisatieconfiguratie te gebruiken:

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

Gebruik deze configuratie met de containerhost:

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

In plaats van deze azure-cloud-initialisatieconfiguratie te gebruiken:

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

Gebruik deze configuratie met de containerhost:

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

In plaats van deze azure-cloud-initialisatieconfiguratie te gebruiken:

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

Gebruik deze configuratie met de containerhost:

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

In plaats van deze azure-cloud-initialisatieconfiguratie te gebruiken:

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

Gebruik deze configuratie met de containerhost:

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

In plaats van deze azure-cloud-initialisatieconfiguratie te gebruiken:

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

Gebruik deze configuratie met de containerhost:

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

In plaats van deze azure-cloud-initialisatieconfiguratie te gebruiken:

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

Gebruik deze configuratie met de containerhost:

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

In plaats van deze azure-cloud-initialisatieconfiguratie te gebruiken:

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

Gebruik deze configuratie met de containerhost:

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

In plaats van deze azure-cloud-initialisatieconfiguratie te gebruiken:

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

Gebruik deze configuratie met het containereindpunt:

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

Wanneer u de Speech CLI in een container gebruikt, neemt u de --host ws://localhost:5000/ optie op. U moet ook opgeven --key none om ervoor te zorgen dat de CLI geen spraaksleutel probeert te gebruiken voor verificatie. Zie Aan de slag met de Azure AI Speech CLI voor informatie over het configureren van de Speech CLI.

Probeer de snelstart voor spraak-naar-tekst met behulp van hostverificatie in plaats van sleutel en regio.

Volgende stappen

• Zie het overzicht van Spraakcontainers
• Configureer containers voor configuratie-instellingen controleren
• Meer Azure AI-containers gebruiken