DokumentasiTerjemahan

Terjemahan

Terjemahkan transkrip ke bahasa lain saat transkripsi atau sesudahnya, lalu baca teks, SRT, dan VTT dua bahasa atau hanya terjemahan.

transcript1 mentranskripsi media lebih dulu, lalu menerjemahkan teks transkrip ke bahasa pilihan Anda. Terjemahan diselaraskan per segmen dan mempertahankan stempel waktu serta pembicara asli. Ini hanya terjemahan teks: tidak ada dubbing dan tidak ada audio terjemahan.

Terjemahan gratis. Terjemahan memakai 0 menit dan tampil di riwayat penggunaan Anda sebagai entri gratis "Translation". Menit transkripsi berlaku seperti biasa, dan terjemahan yang gagal tidak pernah menggagalkan atau mengembalikan transkrip.

Terjemahkan saat transkripsi

Tambahkan translate_to pada permintaan yang membuat transkripsi. Nilainya kode ISO 639-1 dua huruf kecil, misalnya es atau en. Ini berfungsi dengan tautan video di body JSON POST /v1/transcriptions, dengan reservasi unggahan bertahap, dan dengan unggahan multipart satu langkah.

curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "translate_to": "es"}'

Untuk unggahan file, kirim translate_to sebagai kolom formulir:

curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -F [email protected] \
  -F translate_to=en

Alat MCP transcribe juga menerima translate_to. Satu bahasa tujuan per permintaan.

Terjemahkan transkrip yang sudah ada

Minta terjemahan untuk transkripsi yang sudah selesai:

curl -X POST "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD/translations" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language": "en"}'

API menjawab 202:

{
  "transcription_id": "tr_8fK2Lm0PqRsTuVwXyZaBcD",
  "language": "en",
  "status": "processing"
}
StatusArti
404Transkripsi tidak ditemukan.
409 transcript_not_readyTranskripsi belum berstatus completed.
422Bahasa bukan kode dua huruf yang valid.

Panggilan ini idempoten. Terjemahan berstatus processing atau completed dikembalikan apa adanya, dan yang failed dicoba lagi. Alat MCP translate_transcription menerima id dan language.

Baca terjemahan

GET /v1/transcriptions/:id dan unduhan teks, SRT, dan VTT menerima translation:

translationHasil
both (bawaan)Segmen JSON mendapat kolom translation. Teks menaruh baris terjemahan di bawah baris asli. Blok SRT dan VTT berisi dua baris: teks asli, lalu terjemahan.
onlyTeks terjemahan menggantikan text. Stempel waktu dan pembicara tetap sama.
noneHanya transkrip asli.

Respons memuat objek translation, atau null jika tidak ada terjemahan yang diminta:

{
  "translation": { "language": "es", "status": "completed" }
}

status bernilai processing, completed, atau failed. Terjemahan yang gagal juga memuat pesan error. wait turut menunggu terjemahan yang diminta; jika waktu habis, statusnya processing. Alat MCP get_transcription memiliki parameter translation dengan nilai yang sama.

Webhook

Dua event melaporkan hasil terjemahan, selain transcription.completed dan transcription.failed yang tidak berubah:

typeDikirim saat
transcription.translation.completedTerjemahan yang diminta mencapai completed.
transcription.translation.failedTerjemahan yang diminta mencapai failed.

data adalah objek transkripsi ditambah translation: { language, status, error }. Lihat Webhooks untuk tanda tangan dan aturan pengiriman.

Pembaruan terakhir 31 Oktober 2026