BerandaBlog → Cara pindah dari OpenAI Whisper API ke layanan lain

Cara pindah dari OpenAI Whisper API ke layanan lain

Diterbitkan 2026-08-18 · 5 menit baca

Tim meninggalkan Whisper API publik karena berbagai alasan: biaya pada volume besar, ketentuan soal pemrosesan data, atau layanan yang tidak tersedia di wilayahnya. Kabar baiknya, kalau API-nya kompatibel di tingkat protokol, migrasi hanya berarti mengganti dua baris dan selesai dalam semalam.

Apa persisnya yang berubah di kode

Tepat dua hal: alamat dan kunci. Sisanya — nama medan, format respons, penanganan galat — tetap seperti sebelumnya.

# sebelumnya
client = OpenAI(api_key="sk-…")

# sekarang
client = OpenAI(base_url="https://voicesscribe.com/v1", api_key="vs_live_…")

Pemanggilan pengenalan sama sekali tidak disentuh:

result = client.audio.transcriptions.create(model="whisper-1", file=f)

Parameter model dipertahankan demi kompatibilitas: layanan menerima nilai yang biasa dipakai dan menjalankan modelnya sendiri.

Kompatibilitas sampai ke detail

ApaSama
Endpoint POST /v1/audio/transcriptionsya
Medan berkas file, permintaan multipartya
Parameter language, prompt, temperature, response_formatya
Format respons: json, text, verbose_json, srt, vttya
Struktur galat {"error": {"message", "type", …}}ya

Butir terakhir lebih penting daripada kelihatannya: SDK resmi mengurai galat menjadi pengecualian bertipe. Kalau server menjawab dengan formatnya sendiri, kode klien pecah di tempat yang tidak diduga — kompatibilitas galat menyelamatkan Anda dari menulis ulang penangan.

Cara membandingkan kualitas sebelum beralih

Jangan pindahkan produksi tanpa melihat. Urutan yang masuk akal:

  1. Kumpulkan sampel. 20–50 rekaman nyata: bersih, berisik, pendek, beda bahasa — seperti kondisi sehari-hari.
  2. Jalankan di kedua layanan dengan satu skrip, simpan hasilnya berdampingan.
  3. Bandingkan dengan kriteria Anda. Yang penting bukan persentase abstrak, melainkan kasus Anda: apakah kode produk, nama, dan angka keluar benar.
  4. Pindahkan bertahap. Arahkan 10% lalu lintas ke layanan baru, beberapa hari kemudian seluruhnya.
for path in sampel:
    with open(path, "rb") as f:
        a = old_client.audio.transcriptions.create(model="whisper-1", file=f).text
    with open(path, "rb") as f:
        b = new_client.audio.transcriptions.create(model="whisper-1", file=f).text
    print(path, "\n  sebelum:", a, "\n  sesudah:", b)

Yang perlu diperiksa terpisah

Kapan migrasi memang layak

Berganti penyedia masuk akal bila setidaknya satu syarat ini terpenuhi:

Kalau tidak satu pun berlaku, tidak ada alasan mengutak-atik integrasi yang sudah jalan — kompatibilitasnya tetap memungkinkan pindah semalam kapan pun nanti.

Coba dengan rekaman Anda sendiri. Pendaftaran memakan waktu satu menit, dan menit gratisnya cukup untuk menilai kualitasnya.

Ambil kunci API gratis

Pertanyaan yang sering diajukan

Apakah kodenya harus ditulis ulang saat migrasi?

Tidak, kalau Anda memakai SDK resmi openai: yang berubah hanya alamat basis dan kunci. Pemanggilan, parameter, dan pembacaan respons tetap sama.

Apakah format srt dan vtt tetap berfungsi?

Ya, semua nilai response_format yang biasa didukung: json, text, verbose_json, srt, dan vtt.

Bagaimana dengan penanganan galat di SDK?

Galat dikembalikan dalam format yang sama seperti OpenAI, jadi SDK mengubahnya menjadi pengecualian bertipe — penangan yang sudah ada tetap bekerja.

Bisakah dua layanan dipakai bersamaan?

Bisa. Buat dua klien dengan base_url berbeda dan arahkan sebagian lalu lintas ke yang baru — cara praktis membandingkan kualitas dengan data nyata.

Apakah nilai model perlu diganti?

Tidak. Nilai yang biasa dipakai diterima demi kompatibilitas, dan layanan memakai model pengenalannya sendiri.

Bacaan terkait