Lewati ke konten utama
TransConvert

Audio Conversion API

Convert audio between any of 23 supported formats — MP3, WAV, OGG, AAC, FLAC, M4A, WMA, OPUS, AIFF, AMR, AU, CAF, AC3, DTS, GSM, IRCAM, MP2, TTA, VOC, W64, WV, SPX, and RM. Like video, this is an async, submit-then-poll endpoint rather than one blocking request — same ffmpeg engine behind TransConvert's website converter.

Konversi video dan audio bisa berjalan selama beberapa menit — terlalu lama untuk mempertahankan satu permintaan sinkron tetap terbuka — sehingga menggunakan alur submit-lalu-poll, bukan endpoint di atas. Kirim sebuah file, dapatkan job_id sebagai balasan langsung, lalu poll statusnya sampai selesai.

Kirim tugas

POST https://transconvert.com/api/v1/convert-async.php
Field Description
AuthorizationRequired. "Bearer tc_live_...".
categorySet to "audio".
targetRequired. Output format code: "MP3", "WAV", "OGG", "AAC", "FLAC", "M4A", "WMA", "OPUS", "AIFF", "AMR", "AU", "CAF", "AC3", "DTS", "GSM", "IRCAM", "MP2", "TTA", "VOC", "W64", "WV", "SPX", or "RM".
fileRequired. The audio file.
TransConvert
curl -X POST \
  https://transconvert.com/api/v1/convert-async.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=audio" \
  -F "target=MP3" \
  -F "file=@track.wav" \
  -o output.mp3

Poll status

Poll endpoint ini setiap beberapa detik menggunakan job_id yang Anda terima. "status" berupa salah satu dari queued, processing, completed, atau failed.

GET https://transconvert.com/api/v1/job-status.php?job_id=job_...
cURL
curl -H "Authorization: Bearer tc_live_your_key_here" \
  https://transconvert.com/api/v1/job-status.php?job_id=job_...

Unduh hasilnya

Setelah status menjadi "completed", respons menyertakan download_url — URL status yang sama dengan tambahan &download=1. Meminta URL ini akan menstream byte mentah file hasil konversi, dengan header yang sama seperti endpoint lain di halaman ini. Hasil akan dihapus begitu diunduh, atau otomatis dihapus setelah periode penyimpanan singkat jika tidak pernah diunduh.

scheduleHasil tugas dihapus segera setelah diunduh, atau otomatis dihapus setelah periode penyimpanan singkat jika tidak pernah diunduh — segera unduh.

Kesalahan

Setiap kegagalan mengembalikan bungkus kesalahan JSON berisi "code" yang dapat digunakan kode Anda untuk pencabangan logika, ditambah "message" yang mudah dibaca manusia. Beberapa kesalahan menyertakan kolom tambahan (misalnya, quota_exceeded menyertakan "limit" dan "used").

Status & code When it happens
401 missing_keyHeader Authorization tidak dikirim.
401 invalid_keyKunci tidak ada, atau sudah dicabut.
403 account_suspendedAkun pemilik kunci ini telah ditangguhkan.
403 plan_requiredAkun berada di paket Gratis — akses API memerlukan paket Basic, Lite, Pro, atau Tim.
400 invalid_category"category" bukan "image" atau "document".
400 invalid_target"target" bukan format keluaran yang didukung untuk kategori tersebut.
400 no_fileTidak ada file yang dikirim, atau unggahan gagal — kolom harus diberi nama "file".
413 file_too_largeUkuran file melebihi batas unggah maksimum paket Anda.
429 quota_exceededJatah menit konversi bulanan paket Anda telah habis. Akan diatur ulang di awal bulan kalender berikutnya.
429 concurrency_limitTerlalu banyak konversi yang berjalan bersamaan untuk akun ini (dibagi dengan situs web) — tunggu salah satunya selesai lalu coba lagi.
404 job_not_foundTidak ada tugas dengan id tersebut untuk akun ini (juga dikembalikan untuk job_id milik akun lain — keberadaannya tidak pernah diungkapkan).
410 result_goneTugas telah selesai, tetapi hasilnya sudah dihapus (hasil dihapus segera setelah diunduh, atau otomatis setelah periode penyimpanan singkat).
400/415/422/500/503 conversion_failedFile itu sendiri tidak dapat dikonversi — "message" menjelaskan alasannya. Kode status bervariasi tergantung alasannya: 400/415/422 berarti file atau target tidak akan pernah berhasil sebanyak apa pun Anda mencoba ulang; 500/503 berarti ada masalah di sisi server, dan khusus 503 layak dicoba ulang sebentar lagi.

Supported formats

MP3, WAV, OGG, AAC, FLAC, M4A, WMA, OPUS, AIFF, AMR, AU, CAF, AC3, DTS, GSM, IRCAM, MP2, TTA, VOC, W64, WV, SPX, RM

Terkait