AssemblyAI: Universal-3.5 Pro
Universal-3.5 Pro adalah model ucapan-ke-teks AssemblyAI untuk mengubah klip audio singkat menjadi transkrip lengkap dalam satu respons. Profil Sync-nya menambahkan tingkat keyakinan kata, stempel waktu kata opsional, petunjuk kosakata dan konteks percakapan sebelumnya untuk masukan suara serta alur push-to-talk.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Universal-3.5 Pro adalah model pengenalan ucapan AssemblyAI untuk mengubah ucapan rekaman menjadi teks. Dalam profil Sync-nya, klip audio singkat menghasilkan transkrip lengkap dalam satu respons. Ini sesuai untuk pesan suara, masukan push-to-talk dan giliran percakapan terpisah ketika aplikasi sudah mengetahui kapan rekaman harus berakhir.
Siapkan audio sebagai klip berbatas jelas. Persyaratan Sync AssemblyAI menerima durasi dari 80 milidetik hingga 120 detik, dengan ukuran berkas maksimal 40 MB. Format yang didukung adalah WAV atau PCM mentah signed 16-bit little-endian. Audio dapat berupa mono atau stereo, dengan kanal stereo digabungkan menjadi mono secara internal. Laju sampel yang didukung adalah 8, 16, 22,05, 24, 32, 44,1 dan 48 kHz. Header WAV menyediakan laju sampel dan jumlah kanal; PCM mentah memerlukan nilai tersebut diberikan terpisah dalam konfigurasi transkripsi.
Rekam ujaran lengkap dan jaga awal serta akhir ucapan tetap utuh. Tugas orisinal yang berguna adalah pesan suara dukungan produk singkat yang memuat nama produk, pengenal pesanan dan permintaan. Simpan klip sumber agar transkrip dapat diperiksa terhadap detail penting tersebut. Untuk rekaman lebih panjang, siapkan alur yang sesuai dengan transkripsi panjang, alih-alih menganggap batas durasi klip singkat sebagai klaim kapasitas audio seluruh model.
Hasil memuat transkrip lengkap, daftar kata dengan tingkat keyakinan per kata dan tingkat keyakinan keseluruhan antara nol dan satu. Hasil juga menyediakan durasi audio yang dikirim dan pengenal permintaan, sehingga teks dapat tetap terkait dengan klip aslinya. Gunakan tingkat keyakinan kata untuk menemukan bagian yang perlu ditinjau dengan mendengarkan, terutama nama, angka dan kosakata bidang yang penting bagi aplikasi.
Stempel waktu kata bersifat opsional dan nonaktif secara bawaan. Jika diminta, setiap kata yang disejajarkan dapat membawa awal dan akhirnya dalam milidetik relatif terhadap awal klip. Profil pembuatnya membiarkan nilai tersebut tidak ada ketika kata tidak dapat disejajarkan, alih-alih mengarang perkiraan waktu. Akurasi stempel waktu paling baik untuk audio bahasa Inggris. Pertahankan waktu yang hilang secara eksplisit saat menyiapkan penyorotan kata, bentuk gelombang yang dapat dicari atau penyelarasan subtitel, dan bandingkan teks dengan rekaman sebelum menggunakannya sebagai jalur takarir jadi.
Prompt kontekstual menjelaskan pokok rekaman. Prompt dapat menyebutkan bidang, skenario atau detail spesifik yang sudah diketahui aplikasi, dan panjang maksimalnya adalah 6000 karakter. Mulailah dengan deskripsi singkat yang sesuai dengan audio, seperti percakapan dukungan teknis tentang perangkat tertentu. Prompt menyediakan konteks pengenalan; ini bukan permintaan untuk menulis ulang pesan pembicara menjadi dokumen berbeda.
Daftar keyterm terpisah mengarahkan pengenalan agar lebih mengutamakan kosakata tertentu. Profil Sync menerima hingga 100 istilah dan 8000 karakter di seluruh daftar tersebut. Gunakan ejaan tepat untuk nama tidak lazim, akronim atau istilah produk, dan keluarkan kata biasa yang sudah dikenali dengan baik dari daftar. Daftar istilah besar atau tidak diperlukan dapat menyebabkan koreksi berlebihan, sehingga fokuskan daftar pada kata yang penting dalam rekaman. Deskripsi konteks dan daftar kosakata dapat digunakan bersama.
Percakapan sebelumnya juga dapat membantu menafsirkan balasan singkat. Sertakan ujaran sebelumnya sesuai urutan waktu, dari terlama ke terbaru, sementara audio saat ini tetap menjadi giliran yang ditranskripsikan. Jatah konteks yang didokumentasikan adalah 500 giliran atau total 16.000 karakter. Jika melebihi batas tersebut atau konteks model yang tersedia, entri terlama dihapus terlebih dahulu. Ini berguna ketika jawaban singkat memuat pengenal atau rujukan yang maknanya berasal dari pertanyaan sebelumnya.
Pemilihan bahasa mengarahkan pengenalan ke satu atau beberapa bahasa yang diharapkan. Antarmuka Sync saat ini menerima 32 kode bahasa dan secara bawaan menggunakan bahasa Inggris jika tidak ada pilihan yang disertakan. Untuk audio yang beralih bahasa, cantumkan bahasa yang diharapkan. Prompt kontekstual khusus menggantikan bawaan yang dikelola dan mengesampingkan pengarahan kode bahasa terpisah, sehingga sebutkan bahasa yang diharapkan di dalam prompt tersebut ketika konteks bahasa maupun skenario dibutuhkan. Pertahankan transkrip dalam bahasa yang benar-benar diucapkan, alih-alih memperlakukan transkripsi sebagai instruksi terjemahan.
Model juga muncul dalam alur transkripsi AssemblyAI lainnya, sementara persyaratan klip singkat dan bidang hasil profil Sync merupakan milik antarmuka tertentu ini. Alur Dictation pembuatnya menambahkan tahap pembersihan teks terpisah; transkrip dan pesan yang ditulis ulang merupakan artefak berbeda. Pertahankan ucapan yang dikenali jika langkah pengeditan atau perangkuman berikutnya menghasilkan versi yang dibersihkan, agar kata-kata asli tetap tersedia untuk perbandingan.
Hasil yang berguna meliputi pesan suara yang ditranskripsikan, giliran lengkap untuk asisten, teks audio singkat yang dapat dicari atau daftar kata berwaktu untuk antarmuka tinjauan. Periksa kata-kata penentu terhadap rekaman, pertahankan setiap penyelarasan yang hilang dan jaga klip tetap terhubung dengan teks yang dikembalikan. Hasil pengenalan memberi langkah aplikasi berikutnya transkripsi yang didukung sumber; menjawab permintaan atau mengedit pesan menjadi bagian alur di sekitarnya.
Ailoot Ultra · Transkripsi POST /v1/audio/transcriptions assemblyai/universal-3-5-pro
assemblyai/universal-3-5-proMulai
Universal-3.5 Pro adalah model ucapan-ke-teks AssemblyAI untuk mengubah klip audio singkat menjadi transkrip lengkap dalam satu respons. Profil Sync-nya menambahkan tingkat keyakinan kata, stempel waktu kata opsional, petunjuk kosakata dan konteks percakapan sebelumnya untuk masukan suara serta alur push-to-talk.
- Masukan yang diterima
- Audio
- Hasil
- Teks
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Transkripsi POST /v1/audio/transcriptions
- Masukan
audio- Keluaran
text
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan assemblyai/universal-3-5-pro | Bawaan— |
Kolominput_audio | Jenisobject | PersyaratanWajib | Nilai & batasan | Bawaan— |
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, input_audio |
Parametermaterial_types | Kontrakaudio |
Parametermaterial_conditions | KontrakContoh ini membaca berkas PCM WAV Anda yang benar-benar ada dan tidak kosong, mengodekan seluruh byte berkas sebagai base64, lalu mengirim input_audio.format dengan nilai wav. |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id persis dari catatan media milik Ailoot yang sudah ada
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Paket
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Tarif Ailoot
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Satuan penagihan | Biaya |
|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Satuan penagihan— | Biaya Masukan · Token masukan — / 1K token Keluaran · Token keluaran — / 1K token Masukan · Pembacaan cache — / 1K token Masukan · Penulisan cache — / 1K token Masukan · Penulisan cache, 1 jam — / 1K token |
| Konfigurasidetik audio masukan | Jadwal tarif— | Satuan penagihanper detik audio masukan | Biaya Masukan · detik audio masukan $0.00025 per detik audio masukan |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot Ultra · Transkripsi
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_AUDIO_FILE:?Set the path to your actual PCM WAV recording}"
export AILOOT_AUDIO_FILE
python3 - <<'PY_REQUEST'
import base64, io, json, os, wave
from pathlib import Path
audio = Path(os.environ['AILOOT_AUDIO_FILE']).read_bytes()
if not (audio[:4] == b'RIFF' and audio[8:12] == b'WAVE'):
raise SystemExit('Supply your actual PCM WAV audio file')
with wave.open(io.BytesIO(audio), 'rb') as recording:
if recording.getcomptype() != 'NONE' or recording.getnframes() <= 0:
raise SystemExit('Supply a nonempty PCM WAV recording')
request = {'model': 'assemblyai/universal-3-5-pro', 'input_audio': {'data': base64.b64encode(audio).decode('ascii'), 'format': 'wav'}}
Path('request.json').write_text(json.dumps(request, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/transcriptions \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete original response, headers and actual X-Client-Request-ID.
# Read existing owned records for recovery; do not resubmit an uncertain operation.
Terima dan simpan hasil
Ailoot Ultra · Transkripsi
Isi respons asli secara utuh, status, dan header yang diteruskan. Handler ini tidak menambahkan struktur JSON universal, bidang teks, atau pembungkus tugas.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Simpan semua hasil yang selesai
Simpan setiap respons lengkap, berkas, dan bagian konten yang dikembalikan.
Simpan respons dan header secara lengkap, setiap keluaran aktual, identifikator asli yang dikembalikan, dan semua kolom usage. Pulihkan operasi asli tanpa mengirim ulang permintaan pembuatan.
Jika respons asli perlu diperiksa
Simpan X-Client-Request-ID aktual dan respons secara utuh. Baca aset asli yang dimiliki beserta URL konten bertanda tangan yang persis; jangan pernah kirim ulang pembuatan yang statusnya belum pasti.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolomtext (when present) | Jenis |
Kolomusage (when present) | Jenis |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiIsi JSON atau ID model kanonis eksplisit tidak valid. | Langkah berikutnyaSimpan respons dan perbaiki bidang permintaan yang ditunjukkan. |
Respons401 · authentication_error | KondisiKunci API Ailoot tidak valid. | Langkah berikutnyaGunakan kunci API Ailoot Anda yang diotorisasi. |
Respons403 · permission_error | KondisiGrup kunci tidak mengizinkan metode ini. | Langkah berikutnyaSimpan rincian kesalahan yang dikembalikan. |
Respons404 · not_found_error | KondisiMetode yang dipilih tidak memiliki rute yang diizinkan. | Langkah berikutnyaSimpan rincian kesalahan yang dikembalikan. |
Respons422 · price_unavailable | KondisiTarif yang diterima tidak dapat memperoleh jumlah atau batas masukan yang diwajibkan. | Langkah berikutnyaSimpan respons; gunakan representasi masukan yang diwajibkan oleh tarif yang diterima. |
Respons503 · | KondisiPenyimpanan, rute, harga metode, atau pencadangan dana yang diperlukan tidak tersedia. | Langkah berikutnyaSimpan respons asli secara utuh. Pencadangan dana yang belum pasti tidak mengizinkan pengiriman ulang. |
Respons502 · server_error | KondisiHasil awal, penggunaan, atau penyelesaian tagihan perlu diperiksa. | Langkah berikutnyaSimpan ID permintaan aktual dan respons asli. Baca catatan yang dimiliki yang sudah ada; jangan kirim ulang pembuatan. |
Alias
Alias model
Ailoot Ultra assemblyai/universal-3-5-pro
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · AssemblyAI: Universal-3.5 Pro
- Input dan hasil apa yang tersedia?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:audio→text- Kolom apa yang digunakan permintaan?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:model,input_audio