Beszéd szövegtárolókhoz a Dockerrel

A Beszéd a szöveghez tároló valós idejű beszéd- vagy kötegelt hangrögzítéseket ír át köztes eredményekkel. Ebből a cikkből megtudhatja, hogyan tölthet le, telepíthet és futtathat beszédet szövegtárolóba.

Az előfeltételekről, a tárolók futásának ellenőrzéséről, több tároló ugyanazon a gazdagépen való futtatásáról és a leválasztott tárolók futtatásáról további információt a Speech-tárolók telepítése és futtatása a Dockerrel című témakörben talál.

Tárolólemezképek

A Speech to text tároló lemezképe az összes támogatott verzióhoz és területi beállításhoz megtalálható a Microsoft Container Registry (MCR) szindikátumán. Az adattárban azure-cognitive-services/speechservices/ található, és neve speech-to-text.

A teljes tárolórendszerkép neve: mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text. Egy adott verzió hozzáfűzése vagy hozzáfűzése :latest a legújabb verzió lekéréséhez.

Verzió	Elérési út
Legutóbbi	mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:latest A latest címke lekéri a területi beállítás legújabb képét en-US .
4.6.0	mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:4.6.0-amd64-mr-in

A címkék kivételével latestminden címke a következő formátumban van, és megkülönbözteti a kis- és nagybetűket:

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

A címkék JSON formátumban is elérhetők az Ön kényelme érdekében. A törzs tartalmazza a tároló elérési útját és a címkék listáját. A címkék nem verzió szerint lesznek rendezve, de "latest" mindig a lista végén jelennek meg, ahogyan az ebben a kódrészletben látható:

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

Tárolórendszerkép lekérése Docker-lekéréssel

Szüksége van az előfeltételekre, beleértve a szükséges hardvert is. Tekintse meg az egyes Speech-tárolókhoz javasolt erőforrások lefoglalását is.

A Docker lekéréses parancsával letölthet egy tárolólemezképet a Microsoft Container Registryből:

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

Fontos

A latest címke lekéri a területi beállítás legújabb képét en-US . További verziók és területi beállítások: speech to text container images.

A tároló futtatása docker-futtatással

A tároló futtatásához használja a docker-futtatási parancsot.

Beszéd szöveggé

Az alábbi táblázat a különböző docker run paramétereket és azok leírását jelöli:

Paraméter	Leírás
{ENDPOINT_URI}	A végpont szükséges a méréshez és a számlázáshoz. További információ: számlázási argumentumok.
{API_KEY}	Az API-kulcs megadása kötelező. További információ: számlázási argumentumok.

Amikor a beszédet szövegtárolóba futtatja, konfigurálja a portot, a memóriát és a processzort a beszédnek megfelelően a szövegtároló követelményeinek és javaslatainak megfelelően.

Íme egy példaparancs docker run helyőrző értékekkel. Meg kell adnia a ENDPOINT_URI következő értékeket: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}

A parancs a következőket hajtja végre:

• Tárolót speech-to-text futtat a tárolórendszerképből.
• 4 processzormagot és 8 GB memóriát foglal le.
• Az 5000-s TCP-portot teszi elérhetővé, és egy pszeudo-TTY-t foglal le a tárolóhoz.
• A tárolót a kilépés után automatikusan eltávolítja. A tárolólemezkép továbbra is elérhető a gazdaszámítógépen.

A szöveghez való csatlakozás megszakadt

Ha leválasztott tárolókat szeretne futtatni (nem csatlakozik az internethez), el kell küldenie ezt a kéreleműrlapot , és meg kell várnia a jóváhagyást. A tárolók leválasztott környezetekben való használatára vonatkozó kötelezettségvállalási terv alkalmazásával és megvásárlásával kapcsolatos további információkért lásd : Tárolók használata leválasztott környezetekben az Azure AI-szolgáltatások dokumentációjában.

Ha az internetről leválasztott tároló futtatására van jóváhagyva, az alábbi példa a használandó parancs formázását docker run mutatja be helyőrző értékekkel. Cserélje le ezeket a helyőrző értékeket a saját értékeire.

A DownloadLicense=True parancs paramétere docker run letölt egy licencfájlt, amely lehetővé teszi a Docker-tároló futtatását, ha nincs internetkapcsolata. Emellett egy lejárati dátumot is tartalmaz, amely után a licencfájl érvénytelen a tároló futtatásához. Csak a megfelelő tárolóval rendelkező licencfájlt használhatja. Például nem használhat licencfájlt tárolóval speech-to-text rendelkező neural-text-to-speech tárolókhoz.

Helyőrző	Leírás
{IMAGE}	A használni kívánt tárolórendszerkép. Például: mcr.microsoft.com/azure-cognitive-services/speech-to-text:latest
{LICENSE_MOUNT}	A licenc letöltési és csatlakoztatási útvonala. Például: /host/license:/path/to/license/directory
{ENDPOINT_URI}	A szolgáltatáskérés hitelesítésének végpontja. Az erőforrás kulcs- és végpontoldalán , az Azure Portalon található. Például: https://<your-resource-name>.cognitiveservices.azure.com
{API_KEY}	A Speech-erőforrás kulcsa. Az erőforrás kulcs- és végpontoldalán , az Azure Portalon található.
{CONTAINER_LICENSE_DIRECTORY}	A licencmappa helye a tároló helyi fájlrendszerében. Például: /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} 

A licencfájl letöltése után a tárolót leválasztott környezetben futtathatja. Az alábbi példa a használt parancs formázását docker run mutatja be helyőrző értékekkel. Cserélje le ezeket a helyőrző értékeket a saját értékeire.

Bárhol is fut a tároló, a licencfájlt csatlakoztatni kell a tárolóhoz, és meg kell adni Mounts:License=a tároló helyi fájlrendszerében lévő licencmappa helyét. Kimeneti csatlakoztatást is meg kell adni, hogy meg lehessen írni a számlázási használati rekordokat.

Helyőrző	Érték	Formátum vagy példa
{IMAGE}	A használni kívánt tárolórendszerkép. Például: mcr.microsoft.com/azure-cognitive-services/speech-to-text:latest
{MEMORY_SIZE}	A tárolóhoz lefoglalandó memória mérete. Például: 4g
{NUMBER_CPUS}	A tárolóhoz lefoglalandó cpu-k megfelelő száma. Például: 4
{LICENSE_MOUNT}	Az elérési út, ahol a licenc található és csatlakoztatva van. Például: /host/license:/path/to/license/directory
{OUTPUT_PATH}	A naplózás kimeneti elérési útja. Például: /host/output:/path/to/output/directory További információ: használati rekordok az Azure AI-szolgáltatások dokumentációjában.
{CONTAINER_LICENSE_DIRECTORY}	A licencmappa helye a tároló helyi fájlrendszerében. Például: /path/to/license/directory
{CONTAINER_OUTPUT_DIRECTORY}	A kimeneti mappa helye a tároló helyi fájlrendszerén. Például: /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}

A beszédtárolók alapértelmezett könyvtárat biztosítanak a licencfájl és a számlázási napló futásidőben történő írásához. Az alapértelmezett könyvtárak a /license és a /output.

Amikor ezeket a címtárakat a paranccsal csatlakoztatja a docker run -v tárolóhoz, a tároló futtatása előtt győződjön meg arról, hogy user:group nonroot:nonroot a helyi gépkönyvtár tulajdonjoga meg van adva.

Íme egy mintaparancs a fájl/címtár tulajdonjogának beállításához.

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

A Speech-tárolókkal kapcsolatos docker run további információkért lásd : Speech-tárolók telepítése és futtatása a Dockerrel.

A tároló használata

A Speech-tárolók websocket-alapú lekérdezésvégpont API-kat biztosítanak, amelyek a Speech SDK-n és a Speech CLI-n keresztül érhetők el. Alapértelmezés szerint a Speech SDK és a Speech CLI a nyilvános Speech szolgáltatást használja. A tároló használatához módosítania kell az inicializálási módszert.

Fontos

Ha tárolókkal használja a Speech szolgáltatást, mindenképpen használjon gazdagép-hitelesítést. Ha konfigurálja a kulcsot és a régiót, a kérések a nyilvános beszédszolgáltatáshoz kerülnek. Előfordulhat, hogy a Speech szolgáltatás eredményei nem a vártak. A leválasztott tárolókból érkező kérések sikertelenek lesznek.

Az Azure-felhő inicializálási konfigurációjának használata helyett:

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

Használja ezt a konfigurációt a tároló gazdagépével:

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

Az Azure-felhő inicializálási konfigurációjának használata helyett:

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

Használja ezt a konfigurációt a tároló gazdagépével:

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

Az Azure-felhő inicializálási konfigurációjának használata helyett:

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

Használja ezt a konfigurációt a tároló gazdagépével:

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

Az Azure-felhő inicializálási konfigurációjának használata helyett:

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

Használja ezt a konfigurációt a tároló gazdagépével:

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

Az Azure-felhő inicializálási konfigurációjának használata helyett:

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

Használja ezt a konfigurációt a tároló gazdagépével:

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

Az Azure-felhő inicializálási konfigurációjának használata helyett:

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

Használja ezt a konfigurációt a tároló gazdagépével:

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

Az Azure-felhő inicializálási konfigurációjának használata helyett:

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

Használja ezt a konfigurációt a tároló gazdagépével:

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

Az Azure-felhő inicializálási konfigurációjának használata helyett:

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

Használja ezt a konfigurációt a tárolóvégponttal:

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

Ha a Speech CLI-t egy tárolóban használja, adja meg a --host ws://localhost:5000/ lehetőséget. Azt is meg kell adnia --key none , hogy a parancssori felület ne használjon beszédkulcsot a hitelesítéshez. A Speech CLI konfigurálásáról további információt az Azure AI Speech CLI használatának első lépései című témakörben talál.

Próbálja ki a beszédszöveg gyorsútmutatóját a kulcs és a régió helyett gazdahitelesítés használatával.

Következő lépések

• A Speech-tárolók áttekintése
• Tárolók konfigurálása konfigurációs beállításokhoz
• További Azure AI-tárolók használata