Kontainer ucapan ke teks dengan Docker

Kontainer Ucapan ke teks mentranskripsikan rekaman ucapan atau audio batch real time dengan hasil perantara. Dalam artikel ini, Anda mempelajari cara mengunduh, menginstal, dan menjalankan kontainer ucapan ke teks.

Untuk informasi selengkapnya tentang prasyarat, memvalidasi bahwa kontainer sedang berjalan, menjalankan beberapa kontainer pada host yang sama, dan menjalankan kontainer yang terputus, lihat Menginstal dan menjalankan kontainer Ucapan dengan Docker.

Gambar kontainer

Gambar kontainer Ucapan ke teks untuk semua versi dan lokal yang didukung dapat ditemukan pada sindikat Microsoft Container Registry (MCR ). Itu berada di dalam repositori azure-cognitive-services/speechservices/ dan dinamai speech-to-text.

Nama gambar kontainer yang sepenuhnya memenuhi syarat adalah, mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text. Tambahkan versi tertentu atau tambahkan :latest untuk mendapatkan versi terbaru.

Versi	Jalur
terbaru	mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:latest Tag latest menarik gambar terbaru untuk en-US lokal.
4.6.0	mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:4.6.0-amd64-mr-in

Semua tag, kecuali latest, berada dalam format berikut dan peka huruf besar/kecil:

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

Tag juga tersedia dalam format JSON untuk kenyamanan Anda. Isinya mencakup jalur kontainer dan daftar tag. Tag tidak diurutkan menurut versi, tetapi "latest" selalu disertakan di akhir daftar seperti yang ditunjukkan dalam cuplikan ini:

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

Dapatkan gambar kontainer dengan penarikan docker

Anda memerlukan prasyarat termasuk perangkat keras yang diperlukan. Lihat juga alokasi sumber daya yang direkomendasikan untuk setiap kontainer Ucapan.

Gunakan perintah penarikan docker untuk mengunduh citra kontainer dari Microsoft Container Registry:

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

Penting

Tag latest menarik gambar terbaru untuk en-US lokal. Untuk versi dan lokal tambahan, lihat gambar kontainer ucapan ke teks.

Jalankan kontainer dengan docker run

Gunakan perintah eksekusi docker untuk menjalankan kontainer.

Ucapan ke Teks

Tabel berikut ini menunjukkan berbagai parameter docker run dan deskripsi terkait:

Parameter	Deskripsi
{ENDPOINT_URI}	Titik akhir diperlukan untuk pengukuran dan penagihan. Untuk informasi selengkapnya, lihat argumen penagihan.
{API_KEY}	Kunci API diperlukan. Untuk informasi selengkapnya, lihat argumen penagihan.

Saat Anda menjalankan kontainer ucapan ke teks, konfigurasikan port, memori, dan CPU sesuai dengan persyaratan dan rekomendasi kontainer ucapan ke teks.

Berikut adalah contoh docker run perintah dengan nilai tempat penampung. Anda harus menentukan ENDPOINT_URI nilai dan 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}

Perintah ini:

• speech-to-text Menjalankan kontainer dari gambar kontainer.
• Mengalokasikan 4 core CPU dan memori 8 GB.
• Mengekspos port TCP 5000 dan mengalokasikan pseudo-TTY untuk kontainer.
• Menghapus kontainer secara otomatis setelah kontainer keluar. Gambar kontainer masih tersedia di komputer host.

Ucapan terputus ke teks

Untuk menjalankan kontainer yang terputus (tidak tersambung ke internet), Anda harus mengirimkan formulir permintaan ini dan menunggu persetujuan. Untuk informasi selengkapnya tentang menerapkan dan membeli rencana komitmen untuk menggunakan kontainer di lingkungan yang terputus, lihat Menggunakan kontainer di lingkungan yang terputus dalam dokumentasi layanan Azure AI.

Jika Anda disetujui untuk menjalankan kontainer yang terputus dari internet, contoh berikut menunjukkan pemformatan perintah yang docker run akan digunakan, dengan nilai tempat penampung. Ganti nilai tempat penampung dengan nilai Anda sendiri.

Parameter DownloadLicense=True dalam perintah Anda docker run mengunduh file lisensi untuk memungkinkan kontainer Docker Anda berjalan saat tidak tersambung ke internet. Ini juga berisi tanggal kedaluwarsa, setelah itu file lisensi tidak valid untuk menjalankan kontainer. Anda hanya dapat menggunakan file lisensi dengan kontainer yang sesuai yang disetujui. Misalnya, Anda tidak dapat menggunakan file lisensi untuk speech-to-text kontainer dengan neural-text-to-speech kontainer.

Placeholder	Deskripsi
{IMAGE}	Gambar kontainer yang ingin Anda gunakan. Misalnya: mcr.microsoft.com/azure-cognitive-services/speech-to-text:latest
{LICENSE_MOUNT}	Jalur tempat lisensi diunduh, dan dipasang. Misalnya: /host/license:/path/to/license/directory
{ENDPOINT_URI}	Titik akhir untuk mengautentikasi permintaan layanan Anda. Anda dapat menemukannya di halaman Kunci dan titik akhir sumber daya, di portal Azure. Misalnya: https://<your-resource-name>.cognitiveservices.azure.com
{API_KEY}	Kunci untuk sumber daya Ucapan Anda. Anda dapat menemukannya di halaman Kunci dan titik akhir sumber daya, di portal Azure.
{CONTAINER_LICENSE_DIRECTORY}	Lokasi folder lisensi pada filesystem lokal kontainer. Misalnya: /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} 

Setelah file lisensi diunduh, Anda dapat menjalankan kontainer di lingkungan yang terputus. Contoh berikut menunjukkan pemformatan perintah yang docker run Anda gunakan, dengan nilai tempat penampung. Ganti nilai tempat penampung dengan nilai Anda sendiri.

Di mana pun kontainer dijalankan, file lisensi harus dipasang ke kontainer dan lokasi folder lisensi pada sistem file lokal kontainer harus ditentukan dengan Mounts:License=. Mount output juga harus ditentukan sehingga catatan penggunaan penagihan dapat ditulis.

Placeholder	Nilai	Format atau contoh
{IMAGE}	Gambar kontainer yang ingin Anda gunakan. Misalnya: mcr.microsoft.com/azure-cognitive-services/speech-to-text:latest
{MEMORY_SIZE}	Ukuran memori yang sesuai untuk dialokasikan untuk kontainer Anda. Misalnya: 4g
{NUMBER_CPUS}	Jumlah CPU yang sesuai untuk dialokasikan untuk kontainer Anda. Misalnya: 4
{LICENSE_MOUNT}	Jalur tempat lisensi berada dan dipasang. Misalnya: /host/license:/path/to/license/directory
{OUTPUT_PATH}	Jalur output untuk pengelogan. Misalnya: /host/output:/path/to/output/directory Untuk informasi selengkapnya, lihat catatan penggunaan dalam dokumentasi layanan Azure AI.
{CONTAINER_LICENSE_DIRECTORY}	Lokasi folder lisensi pada filesystem lokal kontainer. Misalnya: /path/to/license/directory
{CONTAINER_OUTPUT_DIRECTORY}	Lokasi folder output pada filesystem lokal kontainer. Misalnya: /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}

Kontainer ucapan menyediakan direktori default untuk menulis file lisensi dan log penagihan saat runtime. Direktori default masing-masing adalah /license dan /output.

Saat Anda memasang direktori ini ke kontainer dengan perintah docker run -v, pastikan direktori mesin lokal diatur kepemilikannya ke user:group nonroot:nonroot sebelum menjalankan kontainer.

Berikut adalah contoh perintah untuk mengatur kepemilikan file/direktori.

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

Untuk informasi selengkapnya tentang docker run kontainer Ucapan, lihat Menginstal dan menjalankan kontainer Ucapan dengan Docker.

Gunakan kontainer

Kontainer ucapan menyediakan API titik akhir kueri berbasis websocket yang diakses melalui Speech SDK dan Speech CLI. Secara default, Speech SDK dan Speech CLI menggunakan layanan Ucapan publik. Untuk menggunakan kontainer, Anda perlu mengubah metode inisialisasi.

Penting

Saat Anda menggunakan layanan Ucapan dengan kontainer, pastikan untuk menggunakan autentikasi host. Jika Anda mengonfigurasi kunci dan wilayah, permintaan akan masuk ke layanan Ucapan publik. Hasil dari layanan Ucapan mungkin bukan yang Anda harapkan. Permintaan dari kontainer yang terputus akan gagal.

Alih-alih menggunakan konfigurasi inisialisasi Azure-cloud ini:

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

Gunakan konfigurasi ini dengan host kontainer:

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

Alih-alih menggunakan konfigurasi inisialisasi Azure-cloud ini:

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

Gunakan konfigurasi ini dengan host kontainer:

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

Alih-alih menggunakan konfigurasi inisialisasi Azure-cloud ini:

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

Gunakan konfigurasi ini dengan host kontainer:

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

Alih-alih menggunakan konfigurasi inisialisasi Azure-cloud ini:

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

Gunakan konfigurasi ini dengan host kontainer:

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

Alih-alih menggunakan konfigurasi inisialisasi Azure-cloud ini:

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

Gunakan konfigurasi ini dengan host kontainer:

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

Alih-alih menggunakan konfigurasi inisialisasi Azure-cloud ini:

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

Gunakan konfigurasi ini dengan host kontainer:

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

Alih-alih menggunakan konfigurasi inisialisasi Azure-cloud ini:

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

Gunakan konfigurasi ini dengan host kontainer:

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

Alih-alih menggunakan konfigurasi inisialisasi Azure-cloud ini:

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

Gunakan konfigurasi ini dengan titik akhir kontainer:

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

Saat Anda menggunakan Speech CLI dalam kontainer, sertakan --host ws://localhost:5000/ opsi . Anda juga harus menentukan --key none untuk memastikan bahwa CLI tidak mencoba menggunakan kunci Ucapan untuk autentikasi. Untuk informasi tentang cara mengonfigurasi Speech CLI, lihat Mulai menggunakan Azure AI Speech CLI.

Coba mulai cepat ucapan ke teks menggunakan autentikasi host alih-alih kunci dan wilayah.

Langkah berikutnya

• Lihat gambaran umum kontainer Ucapan
• Tinjau Mengonfigurasikan kontainer untuk pengaturan konfigurasi
• Gunakan lebih banyak kontainer Azure AI