Bagikan melalui

Memigrasikan kode dari v3.2 ke versi 2024-11-15

REST API Ucapan ke teks digunakan untuk transkripsi cepat, transkripsi batch, dan ucapan kustom. Artikel ini menjelaskan perubahan dari versi 3.2 ke versi 2024-11-15.

Penting

Versi 2024-11-15 REST API ucapan ke teks adalah versi terbaru yang tersedia secara umum.

  • Versi REST API 2024-05-15-preview ucapan ke teks akan dihentikan pada tanggal yang akan diumumkan.
  • UCAPAN ke teks REST API v3.0, v3.1, v3.2, 3.2-preview.1, dan 3.2-preview.2 akan dihentikan pada 1 April 2026.

Untuk informasi selengkapnya tentang peningkatan, lihat panduan migrasi Ucapan ke teks REST API v3.0 ke v3.1, v3.1 ke v3.2, dan v3.2 ke 2024-11-15 .

Jalur dasar

API ucapan kustom beralih dari skema penerapan versi berbasis jalur ke skema berbasis parameter kueri dalam penyelarasan dengan skema penerapan versi Azure API umum. Ini diperlukan perubahan pada jalur dasar yang digunakan. Perbarui jalur dari /speechtotext/v3.2 ke /speechtotext dan tambahkan versi API dengan ?api-version=2024-11-15 ke semua permintaan.

Himpunan data

Properti email dan proses pemberitahuan email yang terhubung dihapus dari API.

Properti duration dalam respons himpunan data diganti namanya dari duration menjadi durationMilliseconds dan sekarang menjadi angka biasa alih-alih string yang diformat ISO8601 (P1D2H3M4S...) menjadi pemrosesan lebih lanjut.

Parameter sasValidityInSeconds kueri diganti namanya menjadi sasLifetimeMinutes untuk mendapatkan file. Penggunaan hanya diperbolehkan untuk akun dengan BYOS dinonaktifkan. Untuk akun yang diaktifkan BYOS, URL SAS tidak dikembalikan.

Properti project dihapus dalam permintaan pembuatan.

Model

Menghapus text properti dalam permintaan pembuatan model. Alternatifnya adalah membuat himpunan data dengan konten teks dan membuat himpunan data terlebih dahulu, yang kemudian digunakan untuk pembuatan model.

Properti email dan proses pemberitahuan email yang terhubung dihapus dari API.

Parameter sasValidityInSeconds kueri diganti namanya menjadi sasLifetimeMinutes untuk mendapatkan file. Penggunaan hanya diperbolehkan untuk akun dengan BYOS (bawa penyimpanan Anda sendiri) dinonaktifkan. Untuk akun yang diaktifkan BYOS, URL SAS tidak dikembalikan.

GET models/id/manifest Operasi sekarang selalu memerlukan masa pakai SAS nonzero. Properti yang sasValidityInSeconds sesuai diganti namanya menjadi sasLifetimeMinutes.

Properti project dihapus dalam permintaan pembuatan.

Evaluasi

Parameter sasValidityInSeconds kueri diganti namanya menjadi sasLifetimeMinutes untuk mendapatkan file. Penggunaan hanya diperbolehkan untuk akun dengan BYOS dinonaktifkan. Untuk akun yang diaktifkan BYOS, URL SAS tidak dikembalikan.

Properti project dihapus dalam permintaan pembuatan

Properti email dan proses pemberitahuan email yang terhubung dihapus dari API.

Titik akhir

API untuk mengambil dan menghapus file log log titik akhir dihapus. Ucapan kustom sekarang mendukung BYOS (bawa penyimpanan Anda sendiri). Hanya akun dengan BYOS yang diaktifkan yang dapat mengaktifkan pengelogan pada titik akhir model. Ini menawarkan pengelolaan penuh file log pada penyimpanan pelanggan alih-alih API proksi.

Menghapus dukungan untuk timeToLive dalam pembuatan titik akhir.

Menghapus text properti dalam permintaan pembuatan titik akhir. Alternatifnya adalah membuat himpunan data dengan konten teks dan membuat himpunan data terlebih dahulu, yang kemudian digunakan untuk pembuatan model. Model ini kemudian dapat digunakan untuk membuat titik akhir.

Tautan titik akhir sekarang hanya mengembalikan titik akhir koneksi websocket, yang digunakan untuk SDK.

Properti project dihapus dalam permintaan pembuatan.

Properti email dan proses pemberitahuan email yang terhubung dihapus dari API.

Transkripsi

Menghapus properti tingkat diarizationEnabled atas transkripsi. Konfigurasi diarisasi disederhanakan ke "diarization": {"maxSpeakers": 2,"enabled": true}. Properti maxSpeakers bersifat opsional dan default ke 2. Properti enabled diperlukan untuk diarisasi.

Pembuatan transkripsi: timeToLive diganti namanya menjadi timeToLiveHours menyertakan perubahan format dari string yang diformat ISO8601 menjadi int sederhana (jumlah jam).

duration Properti dalam respons transkripsi diganti namanya dari duration menjadi durationMilliseconds dan sekarang merupakan angka biasa alih-alih string yang diformat ISO8601 (P1D2H3M4S...) untuk lebih menyederhanakan pemrosesan. File hasil Transkripsi memiliki properti ini ditambahkan untuk konsistensi dengan API.

Parameter sasValidityInSeconds kueri diganti namanya menjadi sasLifetimeMinutes untuk mendapatkan file. Penggunaan hanya diperbolehkan untuk akun dengan BYOS dinonaktifkan. Untuk akun yang diaktifkan BYOS, URL SAS tidak dikembalikan.

Properti project dihapus dalam permintaan pembuatan.

Properti email dan proses pemberitahuan email yang terhubung dihapus dari API.

Proyek

API proyek dihapus.

Langkah berikutnya