- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- Izin IAM
- BatchRecognizeFileMetadata
- RecognitionOutputConfig
- GcsOutputConfig
- InlineOutputConfig
- OutputFormatConfig
- NativeOutputFileFormatConfig
- VttOutputFileFormatConfig
- SrtOutputFileFormatConfig
- ProcessingStrategy
Melakukan pengenalan ucapan asinkron batch: mengirim permintaan dengan file N audio dan menerima operasi yang berjalan lama yang dapat di-polling untuk mengetahui kapan transkripsi selesai.
Permintaan HTTP
POST https://{endpoint}/v2/{recognizer=projects/*/locations/*/recognizers/*}:batchRecognize
Dengan {endpoint}
adalah salah satu endpoint layanan yang didukung.
URL menggunakan sintaksis gRPC Transcoding.
Parameter lokasi
Parameter | |
---|---|
recognizer |
Wajib. Nama Pengenal yang digunakan selama pengenalan. Format yang diharapkan adalah |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "config": { object ( |
Kolom | |
---|---|
config |
Fitur dan metadata audio yang akan digunakan untuk Pengenalan Ucapan Otomatis. Kolom ini yang dikombinasikan dengan kolom |
configMask |
Daftar kolom di Ini adalah daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: |
files[] |
File audio dengan metadata file untuk ASR. Jumlah file maksimum yang diizinkan untuk ditentukan adalah 5. |
recognitionOutputConfig |
Opsi konfigurasi untuk tempat menampilkan transkrip setiap file. |
processingStrategy |
Strategi pemrosesan yang akan digunakan untuk permintaan ini. |
Isi respons
Jika berhasil, isi respons akan berisi instance Operation
.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/cloud-platform
Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.
Izin IAM
Memerlukan izin IAM berikut pada resource recognizer
:
speech.recognizers.recognize
Untuk informasi lebih lanjut, lihat dokumentasi IAM.
BatchRecognizeFileMetadata
Metadata tentang satu file dalam batch untukRecognizers.batchRecognize.
Representasi JSON |
---|
{ "config": { object ( |
Kolom | |
---|---|
config |
Fitur dan metadata audio yang akan digunakan untuk Pengenalan Ucapan Otomatis. Kolom ini yang dikombinasikan dengan kolom |
configMask |
Daftar kolom di Ini adalah daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: |
Kolom union audio_source . Sumber audio, yang merupakan URI Google Cloud Storage. audio_source hanya ada berupa salah satu diantara berikut: |
|
uri |
Cloud Storage URI untuk file audio. |
RecognitionOutputConfig
Opsi konfigurasi untuk output pengenalan.
Representasi JSON |
---|
{ "outputFormatConfig": { object ( |
Kolom | |
---|---|
outputFormatConfig |
Opsional. Konfigurasi untuk format hasil yang disimpan ke |
Kolom union
|
|
gcsOutputConfig |
Jika pesan ini diisi, hasil pengenalan akan ditulis ke URI Google Cloud Storage yang disediakan. |
inlineResponseConfig |
Jika pesan ini terisi, hasil pengenalan akan diberikan dalam pesan Operasi |
GcsOutputConfig
Konfigurasi output untuk Cloud Storage.
Representasi JSON |
---|
{ "uri": string } |
Kolom | |
---|---|
uri |
Awalan URI Cloud Storage yang akan digunakan untuk menulis hasil pengenalan. |
InlineOutputConfig
Jenis ini tidak memiliki kolom.
Konfigurasi output untuk respons inline.
OutputFormatConfig
Konfigurasi untuk format hasil yang disimpan ke output
.
Representasi JSON |
---|
{ "native": { object ( |
Kolom | |
---|---|
native |
Konfigurasi untuk format output native. Jika kolom ini disetel atau jika tidak ada kolom format output lain yang disetel, transkrip akan ditulis ke sink dalam format native. |
vtt |
Konfigurasi untuk format output VTT. Jika kolom ini disetel, transkrip akan ditulis ke sink dalam format VTT. |
srt |
Konfigurasi untuk format output SRT. Jika kolom ini disetel, transkrip akan ditulis ke sink dalam format SRT. |
NativeOutputFileFormatConfig
Jenis ini tidak memiliki kolom.
Konfigurasi output untuk proto BatchRecognizeResults
serial.
VttOutputFileFormatConfig
Jenis ini tidak memiliki kolom.
Konfigurasi output untuk file subtitel berformat WebVTT.
SrtOutputFileFormatConfig
Jenis ini tidak memiliki kolom.
File subtitel berformat SubRip Text konfigurasi output.
ProcessingStrategy
Strategi pemrosesan yang mungkin digunakan untuk permintaan batch.
Enum | |
---|---|
PROCESSING_STRATEGY_UNSPECIFIED |
Nilai default untuk strategi pemrosesan. Permintaan akan diproses segera setelah diterima. |
DYNAMIC_BATCHING |
Jika dipilih, proses permintaan selama periode penggunaan yang lebih rendah untuk mendapatkan diskon harga. Permintaan akan dipenuhi dalam waktu 24 jam. |