TokenLab
Dapatkan kunci API
DokumentasiReferensi APIIntegrasi

Audio & realtime

Buat Terjemahan

Menerjemahkan audio ke dalam teks bahasa Inggris

POST
/v1/audio/translations

Ringkasan

Menerjemahkan audio dalam bahasa apa pun yang didukung ke dalam teks bahasa Inggris. Tidak seperti transcription, endpoint ini selalu menghasilkan teks bahasa Inggris terlepas dari bahasa input.

Endpoint ini menerjemahkan audio ke bahasa Inggris. Jangan kirim language; terjemahan audio tidak mendukung parameter ini dan dapat mengembalikan unsupported_parameter. Untuk terjemahan teks, gunakan POST /v1/translations; recommended_for=translation merujuk ke API teks tersebut.

Isi Permintaan

Respons dikembalikan setelah terjemahan selesai. Untuk audio panjang, atur batas waktu HTTP setidaknya 120s.

filefilewajib

File audio yang akan diterjemahkan. Format yang didukung: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. Ukuran file maksimum adalah 25 MB.

modelstringbawaan: whisper-1

ID model terjemahan audio, misalnya whisper-1. Pastikan detail model terkini mendukung POST /v1/audio/translations.

promptstring

Teks opsional untuk memandu gaya model atau melanjutkan segmen sebelumnya. Harus dalam bahasa Inggris.

response_formatstringbawaan: json

Format keluaran. Whisper mendukung json, text, srt, verbose_json, dan vtt; model lain dapat mendukung pilihan berbeda. Periksa detail model.

temperaturenumber

Temperatur sampling dari 0 hingga 1, hanya untuk model yang mendukung parameter ini.

Respons

Field berikut menjelaskan respons JSON transkripsi atau terjemahan. text, srt, dan vtt mengembalikan teks atau subtitel mentah, bukan objek JSON. Field tambahan bergantung pada model dan format keluaran.

textstring

Teks terjemahan dalam bahasa Inggris.

Untuk format verbose_json, response juga mencakup:

languagestring

Label bahasa dalam respons, jika tersedia.

durationnumber

Durasi audio input dalam detik.

segmentsarray

Segmen dari teks terjemahan beserta timestamp.

Permintaan

curl -X POST "https://api.tokenlab.sh/v1/audio/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "file=@german_audio.mp3" \
  -F "model=whisper-1"

Respons

{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you from?"
}

Terjemahan vs Transcription

FiturTerjemahanTranscription
Bahasa outputSelalu bahasa InggrisSama seperti input
Kasus penggunaanMengonversi audio berbahasa asing ke bahasa InggrisMempertahankan bahasa asli
Parameter bahasaTidak berlakuPetunjuk opsional

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Header

X-TokenLab-Delivery-Policy?string

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

Buat Transkripsi

Sebelumnya

Realtime WebSocket

Berikutnya