Audio & realtime

Buat Terjemahan

Menerjemahkan audio menjadi teks bahasa Inggris

POST
/v1/audio/translations

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.

filefilewajib

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

modelstringwajib

Saat ini tidak ada model publik yang menyatakan dukungan untuk POST /v1/audio/translations; tidak ada ID model default atau yang dapat disalin.

promptstring

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

response_formatstringbawaan: json

Format output. Nilai yang diterima bergantung pada model; periksa detailnya. text mengembalikan teks mentah alih-alih objek JSON.

temperaturenumber

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.

textstring

Teks terjemahan dalam bahasa Inggris.

Untuk format verbose_json, respons juga mencakup:

languagestring

Label bahasa yang dilaporkan dalam respons, jika disediakan.

durationnumber

Durasi audio input dalam detik.

segmentsarray

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

FiturTerjemahanTranskripsi
Bahasa outputSelalu bahasa InggrisSama seperti input
Kasus penggunaanMengonversi audio bahasa 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