Audio & realtime
Buat Terjemahan
Menerjemahkan audio menjadi teks bahasa Inggris
Gambaran Umum
Menerjemahkan audio dalam bahasa apa pun yang didukung menjadi teks bahasa Inggris. Berbeda dengan transkripsi, endpoint ini selalu menghasilkan teks bahasa Inggris terlepas dari bahasa inputnya.
Endpoint ini menerjemahkan audio ke dalam bahasa Inggris. Jangan mengirimkan language; parameter ini tidak didukung untuk terjemahan audio dan dapat mengembalikan unsupported_parameter. Untuk terjemahan teks, gunakan POST /v1/translations; recommended_for=translation merujuk pada API teks tersebut.
Body Permintaan
Terjemahan dikembalikan saat pemrosesan selesai. Untuk audio yang lebih panjang, berikan batas waktu (timeout) HTTP client setidaknya 120s.
File audio yang akan diterjemahkan. Format yang didukung: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. Ukuran file maksimum adalah 25 MB.
Saat ini tidak ada model publik yang menyatakan dukungan untuk POST /v1/audio/translations; tidak ada ID model default atau yang dapat disalin.
Teks opsional untuk memandu gaya model atau melanjutkan segmen sebelumnya. Harus dalam bahasa Inggris.
jsonFormat output. Nilai yang diterima bergantung pada model; periksa detailnya. text mengembalikan teks mentah alih-alih objek JSON.
Suhu pengambilan sampel (sampling temperature) dari 0 hingga 1, hanya untuk model yang mencantumkan parameter ini.
Respons
Bidang-bidang di bawah ini menjelaskan respons transkrip atau terjemahan JSON. text, srt, dan vtt mengembalikan teks mentah atau subtitel alih-alih objek JSON. Bidang tambahan bergantung pada model dan format output.
Teks terjemahan dalam bahasa Inggris.
Untuk format verbose_json, respons juga mencakup:
Label bahasa yang dilaporkan dalam respons, jika disediakan.
Durasi audio input dalam detik.
Segmen teks terjemahan beserta stempel waktu (timestamps).
Permintaan
curl -X POST "https://api.tokenlab.sh/v1/audio/translations" \
-H "Authorization: Bearer sk-your-api-key" \
-F "model=your-model-id" \
-F "file=@german_audio.mp3"Respons
{
"text": "Hello, my name is Wolfgang and I come from Germany. Where are you from?"
}Terjemahan vs Transkripsi
| Fitur | Terjemahan | Transkripsi |
|---|---|---|
| Bahasa output | Selalu bahasa Inggris | Sama seperti input |
| Kasus penggunaan | Mengonversi audio bahasa asing ke bahasa Inggris | Mempertahankan bahasa asli |
| Parameter bahasa | Tidak berlaku | Petunjuk opsional |
Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Header
Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.
Nilai yang tersedia
- "auto"
- "verified"
- "official"
Body permintaan
multipart/form-data
Respons
application/json
application/json
application/json
application/json
application/json
application/json