Transkripsi audio lewat API dalam satu request
Masukkan file ke bagian multipart bernama file. Anda bisa menambahkan language, diarize, source dan webhook_url sebagai field form. Ikuti contoh unggahan satu request, atau gunakan webhook untuk menerima kabar saat proses berakhir.
Cara ini cocok jika file sudah ada di server dan ukurannya tidak melebihi 95 MB. Biarkan HTTP client membuat multipart boundary. Kirim isi file yang sebenarnya, bukan teks berisi path lokal dalam JSON. Perbaiki file kosong atau ekstensi yang tidak didukung sebelum mencoba lagi.
Ukuran dan durasi punya batas masing-masing. Audio terkompresi bisa lebih kecil dari 95 MB tetapi berdurasi lebih dari 5 jam. Sebaliknya, video singkat beresolusi tinggi bisa terlalu besar untuk satu request. Pilih cara unggah berdasarkan ukuran byte, lalu periksa durasinya secara terpisah.
curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
-F [email protected] \
-F language=autoUnggah hingga 2 GB tanpa mengulang dari awal
Mulai dengan reservasi berisi nama dan ukuran file. API mengembalikan daftar bagian yang harus dikirim serta X-Upload-Token khusus unggahan tersebut. Panduan unggahan per bagian menjelaskan urutan request lengkapnya.
Ikuti daftar bagian dari API: setiap entri menentukan indeks, offset byte dan ukuran. Baca persis rentang byte tersebut. Bagian terakhir bisa lebih kecil. Gunakan X-Upload-Token untuk request PUT biner; token ini berlaku 1 jam dan bukan pengganti kunci API Anda.
Pertahankan Idempotency-Key yang sama jika request reservasi perlu diulang. Saat token kedaluwarsa, ulangi reservasi dengan key dan parameter yang sama untuk memperoleh token baru bagi unggahan yang sudah ada. Jangan membuat reservasi baru setiap kali koneksi terputus.
curl -X POST "https://api.transcript1.com/v1/transcriptions" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
-H "Idempotency-Key: interview-2026-10-13" \
-H "Content-Type: application/json" \
-d '{"upload":{"filename":"interview.m4a","size":48210334,"mime_type":"audio/mp4"}}'Kirim bagian yang kurang, lalu mulai transkripsi
Kirim setiap bagian dengan PUT dan token unggahan, lalu panggil endpoint penyelesaian. Kami memeriksa kelengkapan file sebelum memasukkannya ke antrean transkripsi. Lihat endpoint unggahan untuk pemeriksaan progres dan penyelesaiannya.
Sebelum melanjutkan, baca GET /v1/transcriptions/:id/upload. Bandingkan received_chunks dengan rencana awal, lalu kirim bagian yang belum ada. Mengirim ulang satu bagian akan menggantinya; ukurannya tetap harus sesuai rencana. Jika mendapat 401, periksa apakah token sudah kedaluwarsa.
Respons 409 upload_incomplete menyebut indeks bagian yang belum diterima. Lengkapi bagian itu sebelum menyelesaikan unggahan. Setelah masuk antrean, periksa status transkripsi atau tunggu webhook. Di antarmuka aplikasi, bedakan progres pengiriman file dari progres transkripsi.
curl -X PUT "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD/upload/chunks/0" \
-H "X-Upload-Token: t1u_..." \
-H "Content-Type: application/octet-stream" \
--data-binary @chunk-0.bin
curl -X POST "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD/upload/complete" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY"File terkirim belum berarti transkripsi dimulai
Status awaiting_upload berarti reservasi masih menunggu file. Transkripsi baru masuk antrean setelah penyelesaian unggahan berhasil. Tampilkan tahap pengiriman byte, pemeriksaan unggahan, lalu pemrosesan audio secara berurutan. Jika koneksi terputus setelah penyelesaian, baca statusnya dulu sebelum mengulang request.
Setiap tim bisa memiliki hingga 20 reservasi unggahan terbuka. Reservasi yang tidak selesai dalam 24 jam dibatalkan dan bagian filenya dihapus. Untuk unggahan yang sudah diproses, file dihapus 24 jam setelah status akhir. Simpan file asli sendiri jika aplikasi Anda menjanjikan pemutaran audio di kemudian hari.
Integrasi yang baik juga membantu pengguna menyiapkan rekaman dan memeriksa teks. Gunakan panduan audio ke teks untuk alur pengguna, atau transkrip wawancara untuk pemetaan peserta dan analisis yang tetap merujuk ke rekaman.